Claude API przyjmie 128 MB w jednym zapytaniu zamiast 32 MB

Anthropic podniósł maksymalny rozmiar zapytania do Messages API i Token Counting API z 32 MB do 128 MB. Zmiana dotyczy Claude API prowadzonego bezpośrednio przez Anthropic i trafiła do Claude Release Notes we wpisie z 28 października.

Co zmienia limit 128 MB w Claude API?

W praktyce chodzi o to, ile danych zmieścimy w jednym wywołaniu POST /v1/messages, zanim API odpowie błędem 413 request_too_large. Do limitu liczy się całe zapytanie: tekst, historia rozmowy, zdjęcia i PDF-y wysłane w base64.

Według dokumentacji wizji pojedyncze zdjęcie może mieć do 10 MB (po zakodowaniu w base64), a w jednym zapytaniu API zmieści się nawet 600 zdjęć (100 dla modeli z oknem kontekstu 200 tys. tokenów). Przy starym limicie kilka dużych zdjęć potrafiło wyczerpać 32 MB, zanim zbliżyliśmy się do limitu liczby obrazów. Teraz zapas jest cztery razy większy.

Podobnie z PDF-ami. Według strony o obsłudze PDF jedno zapytanie obejmuje do 600 stron (100, gdy okno kontekstu zapytania ma mniej niż 1 mln tokenów), a oba limity, stron i rozmiaru, dotyczą całego zapytania. Długie umowy czy skany z grafiką, takie jak te, na które celuje Claude for Legal, łatwiej teraz wysłać w jednym kawałku.

Gdzie obowiązują nowe limity?

Tylko na Claude API prowadzonym przez Anthropic (tzw. „first-party”). Aktualna tabela z przeglądu API wygląda tak:

Endpoint	Maksymalny rozmiar zapytania
Messages, Token Counting	128 MB
Message Batches API	256 MB
Files API	500 MB
Sessions, Agents, Environments	32 MB

Na pozostałych platformach limity są inne:

1. Amazon Bedrock: 20 MB.
2. Claude Models on Google Cloud (zarządzane przez Google): 30 MB.
3. Claude Platform on AWS, Claude Models on Google Cloud (zarządzane przez Anthropic) i Microsoft Foundry: Messages i Token Counting nadal do 32 MB.

Ciekawostka z opisu błędów API: na Claude API błąd 413 zwraca Cloudflare, zanim zapytanie w ogóle dotrze do serwerów API.

Czy to koniec kombinowania z Files API?

Niekoniecznie. Dokumentacja nadal zaleca, żeby duże PDF-y i wiele zdjęć wysyłać przez Files API i odwoływać się do nich przez file_id. Pojedynczy plik może tam mieć 500 MB, a cała organizacja ma 1 TB miejsca.

Jest też kilka ograniczeń, których większy limit nie zmienia:

1. Gdy w zapytaniu jest więcej niż 20 zdjęć, każde z nich podlega ostrzejszemu limitowi wymiarów. Dokumentacja radzi, żeby dłuższy bok nie przekraczał 3000 px albo żeby zostać przy 20 blokach zdjęć i dokumentów.
2. Gęste PDF-y mogą zapełnić okno kontekstu przed osiągnięciem limitu stron, nawet przy Files API.
3. Agenci w Claude Managed Agents (Sessions, Agents, Environments) zostają przy 32 MB.

(Rozmiar zapytania to nie to samo co koszt: każde zdjęcie i każda strona PDF zamienia się w tokeny, więc warto zerknąć, ile naprawdę zużywamy, jak w pomiarach zużycia tokenów w Claude Code.)

Na co zwrócić uwagę?

Po pierwsze, na platformę. Jeśli korzystamy z Claude przez Bedrock, Google Cloud albo Foundry, nic się nie zmieniło, a kod, który działa na Claude API, może tam dostać 413.

Po drugie, na token counting. Limit 128 MB dotyczy też Token Counting API, więc duże zapytanie możemy najpierw policzyć, zanim je wyślemy.

Po trzecie, na brak szczegółów. Wpis w Release Notes ma jedno zdanie i nie mówi, dlaczego limit wzrósł akurat teraz ani czy podobnie zmienią się limity na platformach partnerów.

FAQ

Jaki jest maksymalny rozmiar zapytania w Claude API?

Na Claude API prowadzonym przez Anthropic: 128 MB dla Messages i Token Counting, 256 MB dla Message Batches i 500 MB dla Files API. Sessions, Agents i Environments mają 32 MB.

Co oznacza błąd 413 request_too_large w Claude API?

Że zapytanie przekroczyło limit bajtów dla danego endpointu. Rozwiązaniem jest zmniejszenie zdjęć, podzielenie dokumentu albo wysłanie plików przez Files API i odwołanie się do nich przez file_id.

Czy limit 128 MB działa na Amazon Bedrock?

Nie. Według dokumentacji Bedrock ma limit 20 MB, a Claude Platform on AWS 32 MB dla Messages i Token Counting.

Ile stron PDF można wysłać do Claude w jednym zapytaniu?

Do 600 stron, a gdy okno kontekstu zapytania ma mniej niż 1 mln tokenów, do 100. Całe zapytanie musi przy tym zmieścić się w limicie rozmiaru.