calc.dev.br

API do Claude aceita pedido de 128 MB: a conta em tokens

O teto em megabytes da Messages API ficou quatro vezes maior. O preço por token e a janela de contexto não mudaram, e é a janela que trava primeiro em muitos casos.

Radar · RecursosPor · Redação Grupo TAAPPublicado em 7 min de leitura
Fileira de pastas de arquivo antigas numa prateleira
Um pedido de 128 MB cabe um processo inteiro escaneado, mas o que entra na conta são os tokens. Foto: Mota Ehdaei / Unsplash

O caso: desde 28 de outubro de 2026, a API do Claude aceita pedidos de até 128 MB nas rotas de mensagens e de contagem de tokens, contra 32 MB antes. Uma equipe que manda PDFs escaneados e lotes de fotos quer saber o que passa a caber numa chamada só e quanto isso custa.

Resposta curta: o teto em megabytes ficou 4 vezes maior, mas o que manda na conta continua sendo o token. Seiscentas imagens de 1 megapixel somam 777.600 tokens e custam US$ 1,59 por chamada no Sonnet 5.5. Um PDF de 250 páginas, no exemplo deste texto, custa US$ 1,78 no Sonnet 5.5 e US$ 3,56 no Opus 5.5. A janela de 1.000.000 tokens trava antes dos 128 MB em muitos casos.

O que mudou em 28 de outubro

A nota de versão da Anthropic de 28 de outubro de 2026 diz que o tamanho máximo do pedido subiu de 32 MB para 128 MB na Messages API e na Token Counting API. A mudança vale para a API própria da Anthropic. Ela não muda preço por token. Também não muda a janela de contexto de nenhum modelo.

A página de visão geral da API traz a tabela completa. Quem passa do limite recebe o erro 413 request_too_large.

Onde Limite por pedido
Messages e Token Counting (API da Anthropic) 128 MB
Message Batches API 256 MB
Files API 500 MB
Sessions, Agents e Environments (Managed Agents) 32 MB
Claude Platform on AWS, Google Cloud gerido pela Anthropic e Microsoft Foundry 32 MB
Google Cloud gerido pelo Google 30 MB
Amazon Bedrock 20 MB

O ponto prático: quem usa o Claude por Bedrock, Google Cloud ou Foundry não ganhou nada com essa nota. O limite novo vale só para quem chama api.anthropic.com direto.

Megabyte não é token

O limite em MB mede o tamanho do corpo do pedido. Imagens e PDFs enviados em base64 ocupam cerca de um terço a mais do que o arquivo original, porque é assim que essa codificação funciona. Já o preço e a janela de contexto contam tokens.

Por isso, existem três travas diferentes, e a primeira que você alcançar manda:

  1. Tamanho do pedido: 128 MB na API da Anthropic.
  2. Quantidade: até 600 imagens ou 600 páginas de PDF por pedido. Em modelos com janela de 200 mil tokens, são 100 imagens; em pedidos com janela abaixo de 1 milhão, 100 páginas de PDF.
  3. Janela de contexto: 1.000.000 tokens nos modelos de janela longa, como Opus 5.5 e Sonnet 5.5.

Imagens: o que passa a caber

Pela documentação de visão, o Claude cobra a imagem em blocos de 28 × 28 pixels. Nos modelos de alta resolução (Claude 4.7 em diante), uma imagem chega a no máximo 4.784 tokens. Uma foto de 1000 × 1000 pixels vale 1.296 tokens. Uma de 1920 × 1080, 2.691.

Com 32 MB, 600 imagens precisavam ter em média uns 41 KB cada, já descontado o aumento do base64. Com 128 MB, a média sobe para uns 164 KB.

Mas o token trava antes no caso das imagens grandes:

Imagem Tokens por imagem Tokens de 600 imagens Cabe na janela de 1 milhão? Máximo que cabe
1000 × 1000 px 1.296 777.600 Sim 600 (limite de quantidade)
1920 × 1080 px 2.691 1.614.600 Não 371
2576 × 1449 px (teto da alta resolução) 4.784 2.870.400 Não 209

Há mais um detalhe. Acima de 20 imagens no mesmo pedido, a API aplica um limite de dimensão mais rígido a todas elas. A documentação recomenda deixar cada lado com no máximo 3.000 pixels ou ficar em até 20 blocos de imagem e documento. Por isso a tabela usa imagens que já respeitam esse lado máximo: uma foto 4K precisa ser reduzida antes de entrar num pedido com dezenas de imagens.

Quanto custa a chamada cheia de imagens

Premissa de exemplo: 600 imagens de 1 megapixel e 3.000 tokens de resposta, preços do arquivo do site atualizados em outubro de 2026.

Modelo Entrada por milhão Custo da chamada Em reais
Sonnet 5.5 US$ 2,00 US$ 1,59 R$ 7,94
Opus 5.5 US$ 4,00 US$ 3,17 R$ 15,88
Disco rígido aberto, visto de perto
Megabytes medem o tamanho do arquivo; o preço da API é contado em tokens. Foto: 铮 夏 / Unsplash

PDFs: a janela aperta antes do megabyte

A documentação de PDF diz que cada página costuma gastar de 1.500 a 3.000 tokens de texto, conforme a densidade. E cada página também vira imagem, cobrada pela mesma regra de visão. Ou seja, a página paga texto e imagem.

Para a conta, usamos um exemplo: 2.000 tokens de texto e 1.500 de imagem por página, 3.500 no total. Esses números são exemplo. Meça o seu arquivo com a contagem de tokens da API antes de decidir.

Nesse exemplo, cabem cerca de 285 páginas na janela de 1.000.000 tokens. É menos do que as 600 páginas que a API aceita por pedido. Um PDF escaneado de 60 MB, que antes estourava o limite de 32 MB, agora passa no tamanho. Se tiver muitas páginas, pode estourar a janela.

Páginas Tokens no exemplo Cabe na janela? Sonnet 5.5 Opus 5.5
50 175.000 Sim US$ 0,38 US$ 0,76
250 875.000 Sim US$ 1,78 US$ 3,56
400 1.400.000 Não Divida o arquivo Divida o arquivo

A conta de quem pergunta várias vezes sobre o mesmo PDF

O pedido maior incentiva mandar o documento inteiro de uma vez. Se você fizer 10 perguntas sobre o mesmo PDF de 250 páginas, cada uma numa chamada, o documento é cobrado 10 vezes.

Estratégia no Sonnet 5.5 Custo das 10 perguntas Em reais
Sem cache, documento inteiro toda vez US$ 17,80 R$ 89,17
Com cache de prompt (5 minutos) US$ 3,28 R$ 16,44
API de Lotes, sem cache (50% de desconto) US$ 8,90 R$ 44,59

No cache, a primeira chamada grava o documento e as seguintes leem por uma fração do preço de entrada. Isso exige que o PDF venha no começo do pedido, sempre igual, e que as perguntas cheguem dentro do prazo do cache. Na conta acima, a pergunta tem 300 tokens de exemplo.

A API de Lotes tem limite próprio de 256 MB por pedido e prazo de até 24 horas. Serve para quem não precisa da resposta na hora.

O que fazer agora

  • Confira por onde você chama o Claude. O ganho vale só para a API da Anthropic. No Bedrock, o teto segue em 20 MB.
  • Prefira a Files API para arquivos grandes. A documentação recomenda subir o arquivo e mandar só o file_id, o que deixa o pedido pequeno. O token é cobrado do mesmo jeito.
  • Meça antes de mandar. A Token Counting API aceita os mesmos 128 MB e devolve a contagem sem gerar resposta.
  • Reduza a imagem quando a fidelidade não importa. Imagem maior não paga mais depois do teto de 4.784 tokens, mas imagem menor paga menos.
  • Divida PDFs longos. Melhor várias chamadas dentro da janela do que um erro depois de enviar 128 MB.

Perguntas frequentes

O preço por token mudou com o limite de 128 MB?

Não. A nota de 28 de outubro trata só do tamanho do pedido. Uma chamada com 875.000 tokens de entrada e 3.000 de saída custa US$ 1,78 no Sonnet 5.5, como antes.

Quantas imagens posso mandar numa chamada?

Até 600 por pedido na API, em modelos de janela longa. Na prática, com imagens no teto de 4.784 tokens, só 209 cabem na janela de 1.000.000 tokens. Com fotos de 1 megapixel, as 600 cabem: 777.600 tokens.

Quantas páginas de PDF cabem numa chamada?

A API aceita até 600 páginas por pedido com janela de 1 milhão de tokens. No exemplo deste texto, com 3.500 tokens por página, cabem cerca de 285 páginas. O seu número depende da densidade do arquivo.

Uso o Claude pelo Bedrock. Posso mandar 128 MB?

Não. A documentação da Anthropic indica 20 MB no Bedrock e 30 MB no Google Cloud gerido pelo Google. Claude Platform on AWS, Google Cloud gerido pela Anthropic e Foundry seguem em 32 MB.

Vale mandar o PDF inteiro em vez de só as páginas que importam?

Depende do volume. Cada pergunta sobre o PDF inteiro de 250 páginas custa US$ 1,78 no Sonnet 5.5 sem cache. Com cache, as 10 perguntas saem por US$ 3,28. Se só 50 páginas importam, a chamada cai para US$ 0,38.

Para simular o seu caso com o volume real, use a calculadora de janela de contexto e a calculadora de custo da API.

Refaça a conta com os seus números

A calculadora abaixo já vem com os valores do caso. Mude o que for diferente no seu projeto, ou abra a calculadora completa.

api-cost.ts

Custo da API

tokens
Prompt + histórico + documentos enviados.

tokens

Cache, Batch e cotação do dólar
%

Batch API (−50%)
R$
Cotação de referência; nas calculadoras ela é atualizada com o dólar do dia.

Exemplos

Fontes

  1. Claude Platform · Release notes (28/10/2026) Data e texto da mudança: pedido máximo de 32 MB para 128 MB na Messages API e na Token Counting API
  2. Claude Platform · API overview, Request size limits Tabela de limites por rota (Batches 256 MB, Files 500 MB, Managed Agents 32 MB), erro 413 e limites de Bedrock, Google Cloud e Foundry
  3. Claude Platform · PDF support 600 páginas por pedido (100 abaixo de 1 milhão de janela), 1.500 a 3.000 tokens de texto por página e página cobrada também como imagem
  4. Claude Platform · Vision 600 imagens por pedido, regra de 28×28 px, teto de 4.784 tokens na alta resolução, exemplos de 1.296 e 2.691 tokens e limite mais rígido acima de 20 imagens
  5. calc.dev.br · Calculadora de janela de contexto Para simular o que cabe na janela com o volume real

Preços das páginas oficiais registrados no arquivo do site em 14/10/2026; dólar de referência R$ 5,01 (PTAX de venda do Banco Central em 13/10/2026). Veja a metodologia e a lista completa de fontes.

Mais do Radar