앤스로픽, 클로드 API 요청 크기 128MB로 상향

이미지: 영상 갈무리

요약

앤스로픽은 10월 28일 퍼스트 파티 클로드 API의 Messages·Token Counting 최대 요청 크기를 32MB에서 128MB로 올렸다.
설명 영상에서 0.5MB 이미지로 32MB를 채우면 100만 토큰 컨텍스트의 31%만 쓰고 413 오류가 났고, 128MB에서는 컨텍스트가 96%까지 찬다.
Batches 256MB·Files 500MB·Sessions 등 32MB는 그대로이며, 다른 클라우드 플랫폼은 20~32MB에 머문다.

We've raised the max request size for Messages and Token Counting on the Claude API from 32 MB to 128 MB.

발표: 2026년 10월 28일 릴리스 노트 · 10월 29일 @ClaudeDevs X 영상
대상: 퍼스트 파티 클로드 API Messages API · Token Counting API
변경: 최대 요청 크기 32MB → 128MB(약 4배)
다른 엔드포인트: Message Batches 256MB · Files 500MB · Sessions·Agents·Environments 32MB
초과 시: 413 request_too_large · API 서버 도달 전 클라우드플레어가 반환
영상 예시: 이미지 1장 0.5MB · 4,784토큰 · 32MB 시점 컨텍스트 31%(69% 미사용) · 100MB 시점 96%
이미지 해상도: 20장 초과 요청 긴 변 상한 2,000px → 3,000px(영상) · 고해상도 등급 2,576px·4,784 비주얼 토큰
이미지 수: 요청당 100장(20만 토큰 모델) · 600장(그 밖 모델) · 최대 8000x8000px · 이미지당 10MB(base64)
PDF: 요청당 128MB · 최대 600쪽(100만 토큰 미만 컨텍스트는 100쪽) · 페이지당 텍스트 1,500~3,000토큰
다른 플랫폼: 20~32MB(영상) · 베드록 이미지당 5MB

앤스로픽이 클로드 API의 Messages API와 Token Counting API에서 한 번에 보낼 수 있는 최대 요청 크기를 32MB에서 128MB로 올렸다. 앤스로픽 개발자 플랫폼 릴리스 노트는 10월 28일 자 항목에서 이 변경을 퍼스트 파티 클로드 API에 적용했다고 밝혔다. 클로드 개발자 공식 계정 @ClaudeDevs는 다음 날 X에 "이미지가 많은 요청, 예를 들어 긴 컴퓨터 사용 세션이나 큰 PDF는 컨텍스트 윈도우가 넉넉히 남아 있는데도 32MB에 걸리곤 했다"고 적었다. 같은 글은 "이제 약 4배 더 많은 여유가 생긴다"고 덧붙였다.

이번 조정은 엔드포인트마다 다르게 걸린다. 메탈이 확인한 API 개요 문서의 요청 크기 표에 따르면 Messages와 Token Counting은 128MB, Message Batches API는 256MB, Files API는 500MB다. 관리형 에이전트용 Sessions, Agents, Environments 엔드포인트는 32MB로 그대로 남았다. 한도를 넘긴 요청은 413 request_too_large 오류를 받는다. 오류 문서는 퍼스트 파티 클로드 API에서 이 오류를 요청이 API 서버에 닿기 전에 클라우드플레어가 돌려준다고 설명한다. 서버가 모델을 부르기도 전에 네트워크 앞단에서 바이트 수만으로 요청을 걸러 왔다는 뜻이다.

앤스로픽이 함께 올린 28초 분량의 설명 영상은 문제를 숫자로 보여 준다. 영상 속 예시 이미지는 한 장에 0.5MB, 4,784토큰이다. 이 이미지를 32MB까지 채우면 100만 토큰 컨텍스트 윈도우의 31%만 쓴 상태에서 413 오류가 난다. 영상은 이 장면에 「69% UNUSED」라는 표시를 붙였다. 한도를 128MB로 올린 뒤에는 같은 이미지를 100MB어치 실었을 때 컨텍스트가 96%까지 찬다. 영상은 이 대목을 "이제는 컨텍스트가 먼저 찬다"는 자막으로 정리했다. 바이트 한도가 모델의 기억 용량보다 먼저 바닥나던 순서가 뒤집혔다는 의미다.

영상은 이미지 해상도 한도도 다뤘다. 한 요청에 이미지가 20장을 넘으면 예전에는 이미지 긴 변 2,000픽셀이 상한이었고, 지금은 3,000픽셀이라고 영상은 밝혔다. 비전 문서에 따르면 20장을 넘는 요청에는 모든 이미지에 더 엄격한 이미지당 크기 제한이 걸리고, 이 숫자에는 이전 대화 턴에서 다시 보내는 이미지와 컴퓨터 사용 도구에 돌려주는 스크린샷까지 들어간다. 문서는 모든 플랫폼에서 한도 안에 머물려면 이미지의 어느 변도 3,000픽셀을 넘지 않게 줄이거나 이미지와 문서 블록을 20개 이하로 유지하라고 권한다. 고해상도 등급인 클로드 4.7 이상 모델은 긴 변 2,576픽셀, 최대 4,784 비주얼 토큰까지 이미지를 원본 해상도로 읽는다.

컴퓨터 사용 세션이 이 한도에 먼저 부딪힌 이유도 구조에 있다. 에이전트가 화면을 볼 때마다 스크린샷이 tool_result로 대화에 쌓이고, 다음 요청은 그 기록을 통째로 다시 싣는다. 대화가 길어질수록 텍스트 토큰보다 이미지 바이트가 빠르게 불어난다. 비전 문서는 API에서 요청당 이미지를 컨텍스트 윈도우 20만 토큰 모델은 100장, 그 밖의 모델은 600장까지 받는다고 적고 있다. 이미지 한 장의 최대 크기는 8000x8000픽셀이고, 클로드 API에서 이미지당 용량은 base64 인코딩 기준 10MB다.

PDF 쪽 한도도 함께 바뀌었다. PDF 지원 문서는 최대 요청 크기를 퍼스트 파티 클로드 API 기준 128MB로 적고 있고, 요청당 최대 페이지는 600쪽이다. 요청의 컨텍스트 윈도우가 100만 토큰보다 작으면 100쪽으로 줄어든다. 문서는 두 한도가 PDF와 함께 보내는 다른 콘텐츠까지 포함한 전체 페이로드에 적용된다고 밝히고, 큰 PDF는 Files API로 올린 뒤 file_id로 참조하라고 권한다. 텍스트 토큰은 페이지당 대개 1,500~3,000개이고, 각 페이지가 이미지로도 변환돼 이미지 토큰이 더해진다.

플랫폼에 따른 차이는 남는다. 영상 마지막 화면은 128MB가 클로드 API 기준이며 다른 플랫폼은 20~32MB라고 밝혔다. 비전 문서도 아마존 베드록의 이미지당 용량을 base64 기준 5MB로, 구글이 운영하는 Claude Models on Google Cloud는 base64 이미지만 받고 전체 요청 크기가 더 낮다고 적었다. 같은 코드를 클라우드 마켓플레이스로 옮기면 이번에 늘어난 여유가 그대로 따라가지 않는다는 뜻이다.

메탈은 앤스로픽이 클로드 API의 새 버전 2026-10-21과 새 SDK를 함께 공개한 소식을 보도한 바 있다. 이번 한도 상향은 릴리스 노트에서 특정 API 버전과 묶이지 않은 별도 항목으로 올라왔다. 지금까지 긴 컴퓨터 사용 세션과 이미지 묶음 작업은 컨텍스트가 남아 있어도 요청을 쪼개거나 스크린샷을 덜어 내야 했다. 이제 퍼스트 파티 API에서는 바이트보다 토큰이 먼저 한계가 된다. 남은 설계 과제는 100만 토큰을 무엇으로 채울지, 그리고 그 비용을 어떻게 감당할지다.