PDF-Unterstützung
Verarbeite PDFs mit Claude: Extrahiere Text, analysiere Diagramme und verstehe visuelle Inhalte aus deinen Dokumenten.
Du kannst Claude zu beliebigen Texten, Bildern, Diagrammen und Tabellen in den von dir bereitgestellten PDFs befragen. Einige Beispielanwendungsfälle:
- Analyse von Finanzberichten und Verständnis von Diagrammen/Tabellen
- Extraktion wichtiger Informationen aus juristischen Dokumenten
- Unterstützung bei der Übersetzung von Dokumenten
- Umwandlung von Dokumentinformationen in strukturierte Formate
Bevor du beginnst
PDF-Anforderungen prüfen
Claude funktioniert mit jedem Standard-PDF. Stelle sicher, dass deine Anfragegröße diese Anforderungen erfüllt:
| Anforderung | Limit |
|---|---|
| Maximale Anfragegröße | 128 MB bei der First-Party-Claude-API (variiert je nach Plattform; siehe Limits für die Anfragegröße) |
| Maximale Seitenzahl pro Anfrage | 600 (100, wenn das Kontextfenster der Anfrage unter 1M Token liegt) |
| Format | Standard-PDF (keine Passwörter/Verschlüsselung) |
Beide Limits gelten für die gesamte Anfrage-Payload, einschließlich aller anderen Inhalte, die zusammen mit PDFs gesendet werden. Bei großen PDFs solltest du in Erwägung ziehen, sie mit der Files API hochzuladen und per file_id zu referenzieren, um die Anfrage-Payloads klein zu halten.
Da die PDF-Unterstützung auf den Vision-Fähigkeiten von Claude beruht, unterliegt sie denselben Einschränkungen und Überlegungen wie andere Vision-Aufgaben.
Unterstützte Plattformen und Modelle
Alle aktiven Modelle unterstützen die PDF-Verarbeitung.
PDFs mit Claude verarbeiten
Sende deine erste PDF-Anfrage
Beginne mit einem Beispiel, das die Messages API verwendet. Um Claude ein PDF zu übergeben, sende es in einem document-InhaltsblockVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. mit einer von drei Arten von Quellen. Deine Plattform bestimmt, welche Arten du verwenden kannst (siehe Verfügbarkeit). Wähle unter diesen Arten danach, wo sich das PDF befindet, wie groß es ist und wie oft du es verwendest:
- Ein online gehostetes PDF: Referenziere es über seine URL (Option 1: URL-basiertes PDF-Dokument).
- Ein PDF auf deinem lokalen System oder ohne URL: Sende es als base64-kodierte Daten (Option 2: Base64-kodiertes PDF-Dokument).
- Ein großes PDF oder eines, das du wiederholt verwenden wirst: Lade es mit der Files API hoch und referenziere es per
file_id(Option 3: Files API).
Option 1: URL-basiertes PDF-Dokument
Referenziere das PDF über seine URL:
client = anthropic.Anthropic()
message = client.messages.create(
model="claude-opus-5-5",
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?"},
],
}
],
)
print(message.content)Die Antwort gibt die Analyse von Claude als Textblöcke in content zurück, mit dem Tokenverbrauch in usage:
{
"id": "msg_01Hfp8YuFjQ55VgWbpdHDehB",
"type": "message",
"role": "assistant",
"model": "claude-opus-5-5",
"content": [
{
"type": "text",
"text": "This document is an addendum to the Claude 3 model card, reporting updated evaluation results. The key findings include..."
}
],
"stop_reason": "end_turn",
"usage": {
"input_tokens": 45000,
"output_tokens": 300
}
}Option 2: Base64-kodiertes PDF-Dokument
Sende das PDF als base64-kodierte Daten in der Anfrage selbst. Die meisten der folgenden Beispiele laden ein Beispiel-PDF herunter und kodieren es, sodass sie keine lokale Datei benötigen. Um in diesen Beispielen eine lokale Datei zu senden, ersetze die Zeilen, die das PDF herunterladen und kodieren, durch die auskommentierten Zeilen:
import base64
import httpx2
# Lade und kodiere zuerst das PDF
pdf_url = "https://assets.anthropic.com/m/1cd9d098ac3e6467/original/Claude-3-Model-Card-October-Addendum.pdf"
pdf_data = base64.standard_b64encode(
httpx2.get(pdf_url, follow_redirects=True).content
).decode("utf-8")
# Alternative: Lade aus einer lokalen Datei
# with open("document.pdf", "rb") as f:
# pdf_data = base64.standard_b64encode(f.read()).decode("utf-8")
# Sende mit Base64-Kodierung an Claude
client = anthropic.Anthropic()
message = client.messages.create(
model="claude-opus-5-5",
max_tokens=1024,
messages=[
{
"role": "user",
"content": [
{
"type": "document",
"source": {
"type": "base64",
"media_type": "application/pdf",
"data": pdf_data,
},
},
{"type": "text", "text": "What are the key findings in this document?"},
],
}
],
)
print(message.content)Option 3: Files API
Für PDFs, die du wiederholt verwenden wirst, oder wenn du den Kodierungsaufwand vermeiden möchtest, verwende die Files API:
client = anthropic.Anthropic()
# Lade die PDF-Datei hoch
with open("/path/to/document.pdf", "rb") as f:
file_upload = client.files.upload(file=("document.pdf", f, "application/pdf"))
# Verwende die hochgeladene Datei in einer Nachricht
message = client.messages.create(
model="claude-opus-5-5",
max_tokens=1024,
messages=[
{
"role": "user",
"content": [
{
"type": "document",
"source": {"type": "file", "file_id": file_upload.id},
},
{"type": "text", "text": "What are the key findings in this document?"},
],
}
],
)
print(message.content)So funktioniert die PDF-Unterstützung
Wenn du ein PDF an Claude sendest, laufen die folgenden Schritte ab:
Das System extrahiert die Inhalte des Dokuments.
- Das System wandelt jede Seite des Dokuments in ein Bild um.
- Das System extrahiert den Text jeder Seite und stellt ihn zusammen mit dem Bild dieser Seite bereit.
Claude analysiert sowohl den Text als auch die Bilder.
- Claude erhält jedes Dokument als Kombination aus Text und Bildern.
- Da Claude ein Bild jeder Seite erhält, kannst du Erkenntnisse zu visuellen Elementen eines PDFs anfragen, wie Diagrammen, Schaubildern und anderen nicht-textuellen Inhalten.
Claude verwendet die Inhalte des PDFs in seiner Antwort, falls relevant.
Claude kann in seiner Antwort sowohl auf textuelle als auch auf visuelle Inhalte zurückgreifen.
Schätze deine Kosten
Die Tokenanzahl einer PDF-Datei hängt vom gesamten aus dem Dokument extrahierten Text und der Anzahl der Seiten ab:
- Kosten für Text-Token: Jede Seite verbraucht je nach Inhaltsdichte typischerweise 1.500–3.000 Token. Es gelten die Standard-API-Preise ohne zusätzliche PDF-Gebühren.
- Kosten für Bild-Token: Das Bild jeder Seite verbraucht bei jedem Modell höchstens 1.568 visuelle Token, da die API Seitenbilder an die Limits der Standard-Auflösungsstufe anpasst. Wie du die visuellen Token eines Bildes zählst, erfährst du unter Auflösung und Token-Kosten.
Du kannst die Token-Zählung verwenden, um die Kosten für deine spezifischen PDFs zu schätzen.
PDF-Verarbeitung optimieren
Du kannst die PDF-Unterstützung mit anderen Funktionen kombinieren:
- Prompt-Caching verwenden, um die Leistung bei wiederholter Analyse zu verbessern.
- Dokument-Batches verarbeiten, um Dokumente in großem Umfang zu bearbeiten.
- Tools verwenden, damit Claude spezifische Informationen aus Dokumenten zur Verwendung als Tool-Eingaben extrahiert.
Leistung verbessern
Befolge diese Best Practices für optimale Ergebnisse:
- Platziere PDFs in deinen Anfragen vor dem Text
- Verwende Standardschriftarten
- Stelle sicher, dass der Text klar und lesbar ist
- Drehe Seiten in die korrekte aufrechte Ausrichtung
- Verwende logische Seitenzahlen (aus dem PDF-Viewer) in Prompts
- Teile große PDFs bei Bedarf in Abschnitte auf
- Aktiviere Prompt-Caching für wiederholte Analysen
Skaliere deine Implementierung
Für die Verarbeitung großer Mengen solltest du diese Ansätze in Betracht ziehen:
Prompt-Caching verwenden
Cache PDFs mit Prompt-Caching, um die Leistung bei wiederholten Abfragen zu verbessern:
import base64
import httpx2
# Lade und kodiere zuerst das PDF
pdf_url = "https://assets.anthropic.com/m/1cd9d098ac3e6467/original/Claude-3-Model-Card-October-Addendum.pdf"
pdf_data = base64.standard_b64encode(
httpx2.get(pdf_url, follow_redirects=True).content
).decode("utf-8")
# Erstelle eine Nachricht mit dem gecachten Dokument
client = anthropic.Anthropic()
message = client.messages.create(
model="claude-opus-5-5",
max_tokens=1024,
messages=[
{
"role": "user",
"content": [
{
"type": "document",
"source": {
"type": "base64",
"media_type": "application/pdf",
"data": pdf_data,
},
"cache_control": {"type": "ephemeral"},
},
{
"type": "text",
"text": "Which model has the highest human preference win rates across each use-case?",
},
],
}
],
)
print(message.content)Dokument-Batches verarbeiten
Verwende die Message Batches API, um viele PDFs in einer Anfrage zu verarbeiten:
import base64
import httpx2
# Lade und kodiere zuerst das PDF
pdf_url = "https://assets.anthropic.com/m/1cd9d098ac3e6467/original/Claude-3-Model-Card-October-Addendum.pdf"
pdf_data = base64.standard_b64encode(
httpx2.get(pdf_url, follow_redirects=True).content
).decode("utf-8")
# Erstelle einen Batch von Anfragen, die das Dokument verwenden
client = anthropic.Anthropic()
message_batch = client.messages.batches.create(
requests=[
{
"custom_id": "my-first-request",
"params": {
"model": "claude-opus-5-5",
"max_tokens": 1024,
"messages": [
{
"role": "user",
"content": [
{
"type": "document",
"source": {
"type": "base64",
"media_type": "application/pdf",
"data": pdf_data,
},
},
{
"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-5-5",
"max_tokens": 1024,
"messages": [
{
"role": "user",
"content": [
{
"type": "document",
"source": {
"type": "base64",
"media_type": "application/pdf",
"data": pdf_data,
},
},
{
"type": "text",
"text": "Extract 5 key insights from this document.",
},
],
}
],
},
},
]
)
print(message_batch)Batches werden asynchron verarbeitet. Um den Fortschritt zu prüfen und die Ergebnisse nach Abschluss der Verarbeitung abzurufen, siehe Batch-Verarbeitung.
Nächste Schritte
Erfahre, wie du die visuellen Token eines Bildes zählst und welche Einschränkungen PDFs mit anderen Vision-Aufgaben teilen.
Erkunde praktische Beispiele zur PDF-Verarbeitung im Claude Cookbook-Rezept.
Sieh dir die vollständige API-Dokumentation zur PDF-Unterstützung an.
Verfügbarkeit
Claude API
- APIs
- Messages API
- Managed Agents
- Modelle
- Alle Modelle
Amazon Bedrock
- API
- Messages API
- Modelle
- Alle Modelle
- Hinweis
Nur Base64-Quellen.
Amazon Bedrock (bedrock-runtime)
- API
- Messages API
- Modelle
- Alle Modelle
- Hinweis
Nur Base64-Quellen.
Claude Platform on AWS
- APIs
- Messages API
- Managed Agents
- Modelle
- Alle Modelle
Claude Models on Google Cloud (Anthropic managed)
- APIs
- Messages API
- Managed Agents
- Modelle
- Alle Modelle
Claude Models on Google Cloud (Google managed)
- API
- Messages API
- Modelle
- Alle Modelle
- Hinweis
Nur Base64-Quellen.
Microsoft Foundry
- API
- Messages API
- Modelle
- Alle Modelle
- Hinweis
file_id-Quellen erfordern ein Deployment vom Typ Hosted on Anthropic.
Datenverarbeitung
Übersicht über die DatenverarbeitungZutreffende Endpunkte
/v1/messages
Ausgenommen: Abgedeckte Modelle
Die HIPAA-Berechtigung gilt für PDFs, die inline über die Messages API gesendet werden, nicht über die Files API.
War diese Seite hilfreich?