본문으로 건너뛰기

비전, PDF 및 파일 입력

중급
What you'll learn
  • Claude가 멀티모달인 이유: 한 메시지에 이미지와 문서
  • 파일을 보내는 세 가지 방법: Base64, URL, Files API
  • 비용과 시간을 아끼려고 언제 file_id로 업로드를 재사용할지
  • 비전이 뛰어난 것 — 추출, 시각적 이해, 문서 Q&A
  • 안전하게 쓰는 법: 해상도 한도와 중요한 숫자 검증

Claude는 멀티모달입니다: 메시지에 이미지와 문서(예: PDF)를 포함해 질문할 수 있습니다 — 데이터 추출, 차트 설명, 계약서 요약, 스크린샷 읽기.

파일을 보내는 세 가지 방법​

Guided walkthrough1 of 3
  1. 바이트를 요청에 인라인으로 인코딩합니다. 일회성에 가장 간단합니다.

이미지 콘텐츠 블록이 텍스트 질문과 함께 어떻게 보이는지:

# Conceptual: an image content block alongside text (see docs for exact fields)
messages=[{
  "role": "user",
  "content": [
    {"type": "image", "source": {"type": "base64", "media_type": "image/png", "data": b64}},
    {"type": "text", "text": "What does this chart show? Give the top 3 takeaways."},
  ],
}]

PDF도 비슷하게 작동합니다(문서 콘텐츠 블록); Claude는 텍스트와 시각적 레이아웃을 읽을 수 있고, 답변이 문서의 어디에서 왔는지로 되돌아가는 인용을 요청할 수 있습니다.

무엇에 뛰어난가​

Pro tip
  • 추출 — 인보이스, 양식, 표에서 구조화된 데이터 뽑기(구조화된 출력과 함께: /docs/api/structured-output).
  • 시각 자료 이해 — 차트, 다이어그램, 스크린샷, UI.
  • 문서 Q&A — 긴 PDF 전반에 걸쳐 인용과 함께 질문하기.

문서 Q&A를 위한 빠른 복붙 스타터:

Document Q&A prompt

What does this chart show? Give the top 3 takeaways.

팁​

Key takeaways
  • 같은 큰 문서를 반복해 보낼 때 file_id로 재사용하세요 — 더 저렴하고 빠릅니다.
  • 해상도/크기가 중요합니다 — 아주 큰 이미지는 축소될 수 있으니 한도를 확인하세요.
  • 추출된 숫자를 검증하세요 — 비전은 강력하지만 완벽하지 않으니 중요한 수치는 점검하세요.
Watch out
  • 비전은 강력하지만 완벽하지 않습니다 — 항상 중요한 수치를 점검하세요. 환각(Hallucinations)을 참고하세요: /docs/foundations/hallucinations.

스스로 점검하기

0/3
  1. 파일을 한 번 업로드하고 여러 요청에서 file_id로 참조하게 하는 방법은?
  2. PDF로 문서 Q&A를 할 때 Claude로부터 무엇을 되돌려 요청할 수 있나요?
  3. 왜 중요한 추출 숫자를 점검해야 하나요?

다음​