Claude Platform Docs
MessagesArbeiten mit Dateien

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:

AnforderungLimit
Maximale Anfragegröße128 MB bei der First-Party-Claude-API (variiert je nach Plattform; siehe Limits für die Anfragegröße)
Maximale Seitenzahl pro Anfrage600 (100, wenn das Kontextfenster der Anfrage unter 1M Token liegt)
FormatStandard-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:

  1. Ein online gehostetes PDF: Referenziere es über seine URL (Option 1: URL-basiertes PDF-Dokument).
  2. Ein PDF auf deinem lokalen System oder ohne URL: Sende es als base64-kodierte Daten (Option 2: Base64-kodiertes PDF-Dokument).
  3. 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:

Output
{
  "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:

  1. 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.
  2. 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.
  3. 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:

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

PDF-Unterstützung
APIs
  • Messages API
  • Managed Agents
Modelle
  • Alle Modelle

Zutreffende Endpunkte

  • /v1/messages
Zero Data RetentionBerechtigt

Ausgenommen: Abgedeckte Modelle

HIPAABerechtigt

Die HIPAA-Berechtigung gilt für PDFs, die inline über die Messages API gesendet werden, nicht über die Files API.

War diese Seite hilfreich?