PDFに含まれるテキスト、画像、チャート、表についてClaudeに質問できるようになりました。主なユースケースの例:
Claudeはあらゆる標準的なPDFに対応しています。ただし、PDFサポートを使用する際は、リクエストサイズが以下の要件を満たしていることを確認してください:
| 要件 | 制限 |
|---|---|
| 最大リクエストサイズ | 32MB |
| リクエストあたりの最大ページ数 | 100 |
| フォーマット | 標準PDF(パスワード/暗号化なし) |
両方の制限は、PDFと一緒に送信される他のコンテンツを含む、リクエストペイロード全体に適用されることにご注意ください。
PDFサポートはClaudeのビジョン機能に依存しているため、他のビジョンタスクと同じ制限事項と考慮事項が適用されます。
PDFサポートは現在、直接APIアクセスとGoogle Vertex AIを通じてサポートされています。すべてのアクティブモデルがPDF処理をサポートしています。
PDFサポートは以下の考慮事項とともにAmazon Bedrockでも利用可能になりました:
Amazon BedrockのConverse APIを通じてPDFサポートを使用する場合、2つの異なるドキュメント処理モードがあります:
重要: Converse APIでClaudeの完全なビジュアルPDF理解機能にアクセスするには、引用を有効にする必要があります。引用を有効にしない場合、APIは基本的なテキスト抽出のみにフォールバックします。引用の使用方法の詳細をご覧ください。
Converse Document Chat(従来のモード - テキスト抽出のみ)
Claude PDF Chat(新モード - 完全なビジュアル理解)
Converse APIを使用している際にClaudeがPDF内の画像やチャートを認識しないとお客様から報告があった場合、引用フラグを有効にする必要がある可能性が高いです。引用フラグがない場合、Converseは基本的なテキスト抽出のみにフォールバックします。
これはConverse APIの既知の制約であり、対処に取り組んでいます。引用なしでビジュアルPDF分析が必要なアプリケーションの場合は、代わりにInvokeModel APIの使用を検討してください。
.csv、.xlsx、.docx、.md、.txtファイルなどの非PDFファイルについては、他のファイル形式の操作をご覧ください。
Messages APIを使用した簡単な例から始めましょう。PDFをClaudeに提供する方法は3つあります:
documentコンテンツブロック内のbase64エンコードされたPDFとしてfile_idを使用して最も簡単なアプローチは、URLから直接PDFを参照することです:
curl https://api.anthropic.com/v1/messages \
-H "content-type: application/json" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-d '{
"model": "claude-opus-4-6",
"max_tokens": 1024,
"messages": [{
"role": "user",
"content": [{
"type": "document",
"source": {
"type": "url",
"url": "https://assets.anthropic.com/m/1cd9d098ac3e6467/original/Claude-3-Model-Card-October-Addendum.pdf"
}
},
{
"type": "text",
"text": "What are the key findings in this document?"
}]
}]
}'ローカルシステムからPDFを送信する必要がある場合や、URLが利用できない場合:
# Method 1: Fetch and encode a remote PDF
curl -s "https://assets.anthropic.com/m/1cd9d098ac3e6467/original/Claude-3-Model-Card-October-Addendum.pdf" | base64 | tr -d '\n' > pdf_base64.txt
# Method 2: Encode a local PDF file
# base64 document.pdf | tr -d '\n' > pdf_base64.txt
# Create a JSON request file using the pdf_base64.txt content
jq -n --rawfile PDF_BASE64 pdf_base64.txt '{
"model": "claude-opus-4-6",
"max_tokens": 1024,
"messages": [{
"role": "user",
"content": [{
"type": "document",
"source": {
"type": "base64",
"media_type": "application/pdf",
"data": $PDF_BASE64
}
},
{
"type": "text",
"text": "What are the key findings in this document?"
}]
}]
}' > request.json
# Send the API request using the JSON file
curl https://api.anthropic.com/v1/messages \
-H "content-type: application/json" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-d @request.json繰り返し使用するPDFや、エンコードのオーバーヘッドを避けたい場合は、Files APIを使用してください:
# First, upload your PDF to the Files API
curl -X POST https://api.anthropic.com/v1/files \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: files-api-2025-04-14" \
-F "[email protected]"
# Then use the returned file_id in your message
curl https://api.anthropic.com/v1/messages \
-H "content-type: application/json" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: files-api-2025-04-14" \
-d '{
"model": "claude-opus-4-6",
"max_tokens": 1024,
"messages": [{
"role": "user",
"content": [{
"type": "document",
"source": {
"type": "file",
"file_id": "file_abc123"
}
},
{
"type": "text",
"text": "What are the key findings in this document?"
}]
}]
}'PDFをClaudeに送信すると、以下のステップが実行されます:
システムがドキュメントの内容を抽出します。
Claudeがテキストと画像の両方を分析し、ドキュメントをより深く理解します。
Claudeが関連する場合はPDFの内容を参照して応答します。
Claudeは応答時にテキストコンテンツと視覚的コンテンツの両方を参照できます。PDFサポートを以下と統合することで、パフォーマンスをさらに向上させることができます:
PDFファイルのトークン数は、ドキュメントから抽出されたテキストの総量とページ数に依存します:
トークンカウントを使用して、特定のPDFのコストを見積もることができます。
最適な結果を得るために、以下のベストプラクティスに従ってください:
大量処理の場合、以下のアプローチを検討してください:
繰り返しのクエリでパフォーマンスを向上させるためにPDFをキャッシュします:
# pdf_base64.txtの内容を使用してJSONリクエストファイルを作成
jq -n --rawfile PDF_BASE64 pdf_base64.txt '{
"model": "claude-opus-4-6",
"max_tokens": 1024,
"messages": [{
"role": "user",
"content": [{
"type": "document",
"source": {
"type": "base64",
"media_type": "application/pdf",
"data": $PDF_BASE64
},
"cache_control": {
"type": "ephemeral"
}
},
{
"type": "text",
"text": "Which model has the highest human preference win rates across each use-case?"
}]
}]
}' > request.json
# JSONファイルを使用してAPI呼び出しを実行
curl https://api.anthropic.com/v1/messages \
-H "content-type: application/json" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-d @request.json大量のワークフローにはMessage Batches APIを使用します:
# pdf_base64.txtの内容を使用してJSONリクエストファイルを作成
jq -n --rawfile PDF_BASE64 pdf_base64.txt '
{
"requests": [
{
"custom_id": "my-first-request",
"params": {
"model": "claude-opus-4-6",
"max_tokens": 1024,
"messages": [
{
"role": "user",
"content": [
{
"type": "document",
"source": {
"type": "base64",
"media_type": "application/pdf",
"data": $PDF_BASE64
}
},
{
"type": "text",
"text": "Which model has the highest human preference win rates across each use-case?"
}
]
}
]
}
},
{
"custom_id": "my-second-request",
"params": {
"model": "claude-opus-4-6",
"max_tokens": 1024,
"messages": [
{
"role": "user",
"content": [
{
"type": "document",
"source": {
"type": "base64",
"media_type": "application/pdf",
"data": $PDF_BASE64
}
},
{
"type": "text",
"text": "Extract 5 key insights from this document."
}
]
}
]
}
}
]
}
' > request.json
# JSONファイルを使用してAPI呼び出しを実行
curl https://api.anthropic.com/v1/messages/batches \
-H "content-type: application/json" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-d @request.jsonWas this page helpful?