Claude API: maximale Anfragegröße steigt von 32 MB auf 128 MB

Anthropic hat die maximale Anfragegröße der Claude API für die Messages API und die Token Counting API von 32 MB auf 128 MB angehoben. Die Änderung betrifft die Claude API, die Anthropic direkt betreibt, und steht in den Claude Release Notes im Eintrag vom 28. Oktober.

Was ändert die neue Anfragegröße von 128 MB in der Claude API?

Praktisch geht es darum, wie viele Daten in einen einzigen POST /v1/messages-Aufruf passen, bevor die API mit dem Fehler 413 request_too_large antwortet. Zum Limit zählt die gesamte Anfrage: Text, Gesprächsverlauf sowie Bilder und PDFs, die als base64 mitgeschickt werden.

Laut der Vision-Dokumentation darf ein einzelnes Bild bis zu 10 MB groß sein (nach der base64-Kodierung), und in eine API-Anfrage passen bis zu 600 Bilder (100 bei Modellen mit einem Kontextfenster von 200.000 Tokens). Mit dem alten Limit konnten ein paar große Bilder die 32 MB aufbrauchen, lange bevor man dem Bildlimit auch nur nahe kam. Jetzt ist der Spielraum viermal so groß.

Ähnlich bei PDFs. Laut der Seite zur PDF-Unterstützung umfasst eine Anfrage bis zu 600 Seiten (100, wenn das Kontextfenster der Anfrage unter 1 Mio. Tokens liegt), und beide Limits, Seiten und Größe, gelten für die gesamte Anfrage. Lange Verträge oder Scans mit Grafiken, wie sie Claude for Legal im Visier hat, lassen sich jetzt leichter in einem Stück schicken.

Wo gelten die neuen Limits?

Nur auf der Claude API, die Anthropic selbst betreibt (sogenannte „First-Party“-API). Die aktuelle Tabelle aus der API-Übersicht sieht so aus:

Endpoint	Maximale Anfragegröße
Messages, Token Counting	128 MB
Message Batches API	256 MB
Files API	500 MB
Sessions, Agents, Environments	32 MB

Auf den anderen Plattformen gelten andere Limits:

1. Amazon Bedrock: 20 MB.
2. Claude Models on Google Cloud (von Google verwaltet): 30 MB.
3. Claude Platform on AWS, Claude Models on Google Cloud (von Anthropic verwaltet) und Microsoft Foundry: Messages und Token Counting weiterhin bis 32 MB.

Ein interessantes Detail aus der Beschreibung der API-Fehler: Auf der Claude API liefert Cloudflare den Fehler 413 aus, bevor die Anfrage überhaupt die API-Server erreicht.

Ist das das Ende der Umwege über die Files API?

Nicht unbedingt. Die Dokumentation empfiehlt weiterhin, große PDFs und viele Bilder über die Files API hochzuladen und per file_id zu referenzieren. Eine einzelne Datei darf dort 500 MB groß sein, und die ganze Organisation hat 1 TB Speicherplatz.

Es gibt auch ein paar Einschränkungen, an denen das höhere Limit nichts ändert:

1. Enthält eine Anfrage mehr als 20 Bilder, gilt für jedes davon ein strengeres Limit für die Abmessungen. Die Dokumentation rät, die längere Seite unter 3000 px zu halten oder bei 20 Bild- und Dokumentblöcken zu bleiben.
2. Dichte PDFs können das Kontextfenster füllen, bevor das Seitenlimit erreicht ist, auch mit der Files API.
3. Agenten in Claude Managed Agents (Sessions, Agents, Environments) bleiben bei 32 MB.

(Anfragegröße ist nicht dasselbe wie Kosten: Jedes Bild und jede PDF-Seite wird zu Tokens, also lohnt sich ein Blick darauf, wie viel man wirklich verbraucht, wie bei meinen Messungen zum Tokenverbrauch in Claude Code.)

Worauf sollte man achten?

Erstens auf die Plattform. Wer Claude über Bedrock, Google Cloud oder Foundry nutzt, für den hat sich nichts geändert, und Code, der auf der Claude API läuft, kann dort einen 413 bekommen.

Zweitens auf Token Counting. Das 128-MB-Limit gilt auch für die Token Counting API, man kann eine große Anfrage also erst zählen und dann abschicken.

Drittens auf die fehlenden Details. Der Eintrag in den Release Notes besteht aus einem Satz und sagt weder, warum das Limit gerade jetzt gestiegen ist, noch ob sich die Limits auf Partnerplattformen ähnlich ändern.

FAQ

Wie groß darf eine Anfrage an die Claude API maximal sein?

Auf der von Anthropic betriebenen Claude API: 128 MB für Messages und Token Counting, 256 MB für Message Batches und 500 MB für die Files API. Sessions, Agents und Environments haben 32 MB.

Was bedeutet der Fehler 413 request_too_large in der Claude API?

Dass die Anfrage das Byte-Limit für den jeweiligen Endpoint überschritten hat. Abhilfe schafft es, die Bilder zu verkleinern, das Dokument aufzuteilen oder die Dateien über die Files API hochzuladen und per file_id zu referenzieren.

Gilt das 128-MB-Limit auch auf Amazon Bedrock?

Nein. Laut Dokumentation hat Bedrock ein Limit von 20 MB, und Claude Platform on AWS 32 MB für Messages und Token Counting.

Wie viele PDF-Seiten kann man Claude in einer Anfrage schicken?

Bis zu 600 Seiten, und wenn das Kontextfenster der Anfrage unter 1 Mio. Tokens liegt, bis zu 100. Die gesamte Anfrage muss dabei ins Größenlimit passen.