Claude API 요청 상한 128MB로 4배 확대 — 이미지 많은 요청·컴퓨터 사용의 413 오류 완화

Anthropic · Claude API · ax-trend 이슈 #3648 · 2026-10-29 발표

Claude API 요청 상한 128MB로 4배 확대 — 32MB에서 128MB로
변경 개요 — Messages API와 Token Counting 엔드포인트의 요청 상한이 32MB에서 128MB로 확대됐습니다

변경 내용

Anthropic이 2026년 10월 29일 Claude API의 요청 크기 상한을 올렸습니다. 대상은 Messages API와 Token Counting 엔드포인트이며, 상한은 기존 32MB에서 128MB로, 4배가 됐습니다. 공식 문서의 요청 크기 표에도 두 엔드포인트가 128MB로 반영됐습니다.

함께 바뀐 수치도 있습니다. 20장을 초과하는 이미지 요청의 이미지당 상한이 기존 2000픽셀에서 3000픽셀로 올랐습니다. 상한을 넘기면 413 request_too_large 오류가 반환됩니다.

Messages API 상한32MB → 128MB
확대 배율4배
이미지당 상한 (20장 초과 요청)2000픽셀 → 3000픽셀
클라우드 플랫폼 경유 상한20~32MB 범위

상한 비교

Claude API 요청 상한 비교 — Messages 변경 전 32MB, 변경 후 128MB, Message Batches 256MB, Files API 500MB
상한 비교 — Message Batches API 256MB와 Files API 500MB는 이번에 바뀌지 않았습니다 (출처: Claude 공식 문서)

이번 변경은 Messages 계열에만 해당합니다. Message Batches API는 256MB, Files API는 500MB로 그대로입니다. 따라서 큰 파일을 다루는 워크플로는 어느 엔드포인트를 거치는지부터 확인하는 편이 안전합니다.

상한에 걸리던 배경

이미지가 많은 요청은 기존 상한에 자주 걸렸습니다. 이미지를 base64로 인코딩하면 크기가 약 3분의 1 부풀어, 24MB짜리 PDF도 지시문과 대화 기록을 더하기 전에 상한에 근접했습니다. 컴퓨터 사용 세션에서는 반복된 스크린샷이 한 요청 안에 쌓여, 컨텍스트 여유와 무관하게 413 오류로 대화가 끊기곤 했습니다.

상한 확대는 이런 우회를 줄이는 방향입니다. 큰 PDF와 장시간 컴퓨터 사용 세션을 요청에 담을 때 축소하거나 나누던 작업이 줄고, 요청 설계의 여유가 커집니다.

상한 확대 후 요청 설계 흐름

상한 확대 후 요청 설계 흐름 — 이미지 많은 요청 작성, 상한 128MB 확인, 이미지당 3000픽셀, 413 오류 시 경유 경로 확인
요청 설계 흐름 — 상한이 커졌다고 끝이 아니라, 경유 경로의 별도 상한까지 확인해야 합니다

실무에서 바로 적용할 순서는 네 단계입니다. 먼저 요청에 들어가는 이미지와 문서의 인코딩 후 크기를 가늠하고, Messages API와 Token Counting이 128MB 대상인지 확인합니다. 20장을 넘는 이미지 요청이라면 이미지당 3000픽셀 기준도 함께 봅니다. 그래도 413 오류가 나면 요청 크기보다 경유 경로를 먼저 의심하는 편이 빠릅니다.

주의할 점은 128MB가 1차 Claude API 기준이라는 점입니다. 클라우드 플랫폼을 경유하면 상한은 20MB에서 32MB 사이로, 플랫폼마다 다릅니다. 1차 API 상한이 커졌다고 경유 경로까지 자동으로 커지는 것은 아닙니다.

아직 확인되지 않은 점

실무 시사점

이미지가 많은 에이전트와 문서 처리 워크플로를 만드는 독자에게 직접적인 변화입니다. 다만 상한과 컨텍스트 윈도우는 별개라는 점을 함께 기억할 필요가 있습니다. 요청이 128MB 안에 들어간다고 해서 모델이 그 전부를 컨텍스트로 소화하는 것은 아니기 때문입니다.

도입 판단에서는 크기보다 두 가지를 먼저 보시기 바랍니다. 요청이 1차 API로 직접 가는지, 클라우드 플랫폼을 경유하는지, 그리고 413 오류가 났을 때 어느 단계의 상한에 걸렸는지입니다. 경유 경로가 확인되기 전에는 큰 요청을 그대로 옮기지 않는 편이 안전합니다.

출처

AnthropicAI 인프라AX Trend