Sie können Claude jetzt zu jedem Text, Bildern, Diagrammen und Tabellen in PDFs befragen, die Sie bereitstellen. Einige Beispiel-Anwendungsfälle:

  • Analyse von Finanzberichten und Verstehen von Diagrammen/Tabellen
  • Extraktion wichtiger Informationen aus Rechtsdokumenten
  • Übersetzungshilfe für Dokumente
  • Umwandlung von Dokumentinformationen in strukturierte Formate

​
Bevor Sie beginnen

​
PDF-Anforderungen prüfen

Claude funktioniert mit jedem Standard-PDF. Sie sollten jedoch sicherstellen, dass Ihre Anfragegröße diese Anforderungen erfüllt, wenn Sie PDF-Unterstützung verwenden:

AnforderungLimit
Maximale Anfragegröße32MB
Maximale Seiten pro Anfrage100
FormatStandard-PDF (keine Passwörter/Verschlüsselung)

Bitte beachten Sie, dass beide Limits für die gesamte Anfrage-Payload gelten, einschließlich aller anderen Inhalte, die zusammen mit PDFs gesendet werden.

Da die PDF-Unterstützung auf Claudes Vision-Fähigkeiten basiert, unterliegt sie denselben Einschränkungen und Überlegungen wie andere Vision-Aufgaben.

​
Unterstützte Plattformen und Modelle

PDF-Unterstützung wird derzeit über direkten API-Zugang und Google Vertex AI unterstützt auf:

  • Claude Opus 4 (claude-opus-4-20250514)
  • Claude Sonnet 4 (claude-sonnet-4-20250514)
  • Claude Sonnet 3.7 (claude-3-7-sonnet-20250219)
  • Claude Sonnet 3.5 Modelle (claude-3-5-sonnet-20241022, claude-3-5-sonnet-20240620)
  • Claude Haiku 3.5 (claude-3-5-haiku-20241022)

PDF-Unterstützung ist jetzt auf Amazon Bedrock mit folgenden Überlegungen verfügbar:

​
Amazon Bedrock PDF-Unterstützung

Bei der Verwendung von PDF-Unterstützung über Amazon Bedrocks Converse API gibt es zwei verschiedene Dokumentverarbeitungsmodi:

Wichtig: Um auf Claudes vollständige visuelle PDF-Verständnisfähigkeiten in der Converse API zuzugreifen, müssen Sie Zitate aktivieren. Ohne aktivierte Zitate fällt die API auf nur grundlegende Textextraktion zurück. Erfahren Sie mehr über Arbeiten mit Zitaten.

​
Dokumentverarbeitungsmodi

  1. Converse Document Chat (Ursprünglicher Modus - Nur Textextraktion)

    • Bietet grundlegende Textextraktion aus PDFs
    • Kann keine Bilder, Diagramme oder visuelle Layouts in PDFs analysieren
    • Verwendet etwa 1.000 Token für ein 3-seitiges PDF
    • Wird automatisch verwendet, wenn Zitate nicht aktiviert sind

  2. Claude PDF Chat (Neuer Modus - Vollständiges visuelles Verständnis)

    • Bietet vollständige visuelle Analyse von PDFs
    • Kann Diagramme, Grafiken, Bilder und visuelle Layouts verstehen und analysieren
    • Verarbeitet jede Seite sowohl als Text als auch als Bild für umfassendes Verständnis
    • Verwendet etwa 7.000 Token für ein 3-seitiges PDF
    • Erfordert aktivierte Zitate in der Converse API

​
Wichtige Einschränkungen

  • Converse API: Visuelle PDF-Analyse erfordert aktivierte Zitate. Es gibt derzeit keine Option, visuelle Analyse ohne Zitate zu verwenden (im Gegensatz zur InvokeModel API).
  • InvokeModel API: Bietet vollständige Kontrolle über PDF-Verarbeitung ohne erzwungene Zitate.

​
Häufige Probleme

Wenn Kunden berichten, dass Claude keine Bilder oder Diagramme in ihren PDFs sieht, wenn sie die Converse API verwenden, müssen sie wahrscheinlich das Zitate-Flag aktivieren. Ohne es fällt Converse auf nur grundlegende Textextraktion zurück.

Dies ist eine bekannte Einschränkung der Converse API, an deren Behebung wir arbeiten. Für Anwendungen, die visuelle PDF-Analyse ohne Zitate benötigen, verwenden Sie stattdessen die InvokeModel API.

Für Nicht-PDF-Dateien wie .csv, .xlsx, .docx, .md oder .txt-Dateien siehe Arbeiten mit anderen Dateiformaten.

​
PDFs mit Claude verarbeiten

​
Ihre erste PDF-Anfrage senden

Beginnen wir mit einem einfachen Beispiel unter Verwendung der Messages API. Sie können PDFs auf drei Arten an Claude bereitstellen:

  1. Als URL-Verweis auf ein online gehostetes PDF
  2. Als base64-kodiertes PDF in document Content-Blöcken
  3. Über eine file_id aus der Files API

​
Option 1: URL-basiertes PDF-Dokument

Der einfachste Ansatz ist, ein PDF direkt über eine URL zu referenzieren:

 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-20250514",
     "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": "Was sind die wichtigsten Erkenntnisse in diesem Dokument?"
         }]
     }]
 }'

​
Option 2: Base64-kodiertes PDF-Dokument

Wenn Sie PDFs von Ihrem lokalen System senden müssen oder wenn eine URL nicht verfügbar ist:

# Methode 1: Remote-PDF abrufen und kodieren
curl -s "https://assets.anthropic.com/m/1cd9d098ac3e6467/original/Claude-3-Model-Card-October-Addendum.pdf" | base64 | tr -d '\n' > pdf_base64.txt

# Methode 2: Lokale PDF-Datei kodieren
# base64 document.pdf | tr -d '\n' > pdf_base64.txt

# JSON-Anfragedatei mit dem pdf_base64.txt-Inhalt erstellen
jq -n --rawfile PDF_BASE64 pdf_base64.txt '{
    "model": "claude-opus-4-20250514",
    "max_tokens": 1024,
    "messages": [{
        "role": "user",
        "content": [{
            "type": "document",
            "source": {
                "type": "base64",
                "media_type": "application/pdf",
                "data": $PDF_BASE64
            }
        },
        {
            "type": "text",
            "text": "Was sind die wichtigsten Erkenntnisse in diesem Dokument?"
        }]
    }]
}' > request.json

# API-Anfrage mit der JSON-Datei senden
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

​
Option 3: Files API

Für PDFs, die Sie wiederholt verwenden werden, oder wenn Sie Kodierungs-Overhead vermeiden möchten, verwenden Sie die Files API:

# Zuerst Ihr PDF zur Files API hochladen
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 "file=@document.pdf"

# Dann die zurückgegebene file_id in Ihrer Nachricht verwenden
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-20250514", 
    "max_tokens": 1024,
    "messages": [{
      "role": "user",
      "content": [{
        "type": "document",
        "source": {
          "type": "file",
          "file_id": "file_abc123"
        }
      },
      {
        "type": "text",
        "text": "Was sind die wichtigsten Erkenntnisse in diesem Dokument?"
      }]
    }]
  }'

​
Wie PDF-Unterstützung funktioniert

Wenn Sie ein PDF an Claude senden, laufen folgende Schritte ab:

1

Das System extrahiert die Inhalte des Dokuments.

  • Das System konvertiert jede Seite des Dokuments in ein Bild.
  • Der Text von jeder Seite wird extrahiert und zusammen mit dem Bild jeder Seite bereitgestellt.
2

Claude analysiert sowohl den Text als auch die Bilder, um das Dokument besser zu verstehen.

  • Dokumente werden als Kombination aus Text und Bildern zur Analyse bereitgestellt.
  • Dies ermöglicht es Benutzern, nach Einblicken in visuelle Elemente eines PDFs zu fragen, wie Diagramme, Schaubilder und andere nicht-textuelle Inhalte.
3

Claude antwortet und referenziert dabei die PDF-Inhalte, falls relevant.

Claude kann sowohl textuelle als auch visuelle Inhalte referenzieren, wenn es antwortet. Sie können die Leistung weiter verbessern, indem Sie PDF-Unterstützung integrieren mit:

  • Prompt-Caching: Um die Leistung für wiederholte Analysen zu verbessern.
  • Batch-Verarbeitung: Für hochvolumige Dokumentverarbeitung.
  • Tool-Verwendung: Um spezifische Informationen aus Dokumenten für die Verwendung als Tool-Eingaben zu extrahieren.

​
Ihre Kosten schätzen

Die Token-Anzahl einer PDF-Datei hängt vom gesamten aus dem Dokument extrahierten Text sowie der Anzahl der Seiten ab:

  • Text-Token-Kosten: Jede Seite verwendet typischerweise 1.500-3.000 Token pro Seite, abhängig von der Inhaltsdichte. Standard-API-Preise gelten ohne zusätzliche PDF-Gebühren.
  • Bild-Token-Kosten: Da jede Seite in ein Bild konvertiert wird, werden dieselben bildbasierten Kostenberechnungen angewendet.

Sie können Token-Zählung verwenden, um Kosten für Ihre spezifischen PDFs zu schätzen.

​
PDF-Verarbeitung optimieren

​
Leistung verbessern

Befolgen Sie diese Best Practices für optimale Ergebnisse:

  • Platzieren Sie PDFs vor Text in Ihren Anfragen
  • Verwenden Sie Standard-Schriftarten
  • Stellen Sie sicher, dass Text klar und lesbar ist
  • Drehen Sie Seiten in die richtige aufrechte Ausrichtung
  • Verwenden Sie logische Seitenzahlen (aus PDF-Viewer) in Prompts
  • Teilen Sie große PDFs bei Bedarf in Chunks auf
  • Aktivieren Sie Prompt-Caching für wiederholte Analysen

​
Ihre Implementierung skalieren

Für hochvolumige Verarbeitung betrachten Sie diese Ansätze:

​
Prompt-Caching verwenden

Cachen Sie PDFs, um die Leistung bei wiederholten Abfragen zu verbessern:

# JSON-Anfragedatei mit dem pdf_base64.txt-Inhalt erstellen
jq -n --rawfile PDF_BASE64 pdf_base64.txt '{
    "model": "claude-opus-4-20250514",
    "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": "Welches Modell hat die höchsten menschlichen Präferenz-Gewinnraten in jedem Anwendungsfall?"
        }]
    }]
}' > request.json

# Dann den API-Aufruf mit der JSON-Datei machen
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

​
Dokument-Batches verarbeiten

Verwenden Sie die Message Batches API für hochvolumige Workflows:

# JSON-Anfragedatei mit dem pdf_base64.txt-Inhalt erstellen
jq -n --rawfile PDF_BASE64 pdf_base64.txt '
{
  "requests": [
      {
          "custom_id": "my-first-request",
          "params": {
              "model": "claude-opus-4-20250514",
              "max_tokens": 1024,
              "messages": [
                {
                    "role": "user",
                    "content": [
                        {
                            "type": "document",
                            "source": {
 "type": "base64",
 "media_type": "application/pdf",
 "data": $PDF_BASE64
                            }
                        },
                        {
                            "type": "text",
                            "text": "Welches Modell hat die höchsten menschlichen Präferenz-Gewinnraten in jedem Anwendungsfall?"
                        }
                    ]
                }
              ]
          }
      },
      {
          "custom_id": "my-second-request",
          "params": {
              "model": "claude-opus-4-20250514",
              "max_tokens": 1024,
              "messages": [
                {
                    "role": "user",
                    "content": [
                        {
                            "type": "document",
                            "source": {
 "type": "base64",
 "media_type": "application/pdf",
 "data": $PDF_BASE64
                            }
                        },
                        {
                            "type": "text",
                            "text": "Extrahieren Sie 5 wichtige Erkenntnisse aus diesem Dokument."
                        }
                    ]
                }
              ]
          }
      }
  ]
}
' > request.json

# Dann den API-Aufruf mit der JSON-Datei machen
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.json

​
Nächste Schritte

PDF-Beispiele ausprobieren

Erkunden Sie praktische Beispiele der PDF-Verarbeitung in unserem Cookbook-Rezept.

API-Referenz anzeigen

Sehen Sie die vollständige API-Dokumentation für PDF-Unterstützung.