O caso: uma analista exporta do sistema de vendas um CSV de 4.000 linhas e 8 colunas e quer fazer perguntas à IA sobre ele: quais produtos caíram, qual região cresceu, onde há erro de cadastro. Numa sessão típica ela faz 15 perguntas sobre o mesmo arquivo. Quanto custa isso pela API do Claude?
Resposta curta: a planilha do exemplo dá cerca de 109.804 tokens. Uma sessão de 15 perguntas custa US$ 3,66 no Sonnet 5.5 sem cache e US$ 0,75 com cache de prompt (perto de R$ 3,76). Se ela mandar só um resumo de 200 linhas, a sessão cai para US$ 0,53. Tamanhos e volumes deste guia são exemplo.
Passo 1: conte os tokens da planilha
A API não cobra por linha nem por megabyte. Cobra por token. E uma planilha vira texto antes de chegar ao modelo: cada célula, cada vírgula separadora e cada quebra de linha conta.
Uma conta rápida usa o tamanho do arquivo em caracteres. No exemplo, cada linha tem cerca de 70 caracteres (data, código do produto, nome, região, vendedor, quantidade, preço e total). São 280.000 caracteres no arquivo.
Pela média do site para o Claude em português, 2,55 caracteres por token, isso dá cerca de 109.804 tokens.
Um alerta: números, datas e códigos se dividem em tokens de um jeito diferente do texto corrido. Uma planilha cheia de números pode ter mais tokens do que a média sugere. Antes de decidir, cole umas 50 linhas reais no contador de tokens e multiplique pelo total de linhas.
Passo 2: veja se cabe na janela de contexto
A planilha precisa caber inteira em cada pedido, junto com as instruções, as perguntas e as respostas anteriores. Teste o tamanho na calculadora de janela de contexto.
Esta tabela mostra como os tokens crescem com o número de linhas, mantendo 70 caracteres por linha:
| Linhas | Tokens estimados | Custo de enviar uma vez no Sonnet 5.5 | Em reais |
|---|---|---|---|
| 500 | 13.725 | US$ 0,0275 | R$ 0,1375 |
| 4.000 | 109.804 | US$ 0,2196 | R$ 1,1001 |
| 20.000 | 549.020 | US$ 1,0980 | R$ 5,5007 |
| 50.000 | 1.372.549 | US$ 2,7451 | R$ 13,7518 |
Uma planilha de dezenas de milhares de linhas se aproxima do limite da janela ou passa dele. Nesse ponto, mandar o arquivo inteiro deixa de ser opção, e o passo 5 vira obrigatório.
Passo 3: calcule a primeira pergunta
Cada pedido leva 1.500 tokens de instruções (o que cada coluna significa, como responder), a planilha e a pergunta, de cerca de 120 tokens. A resposta, com uma pequena tabela ou lista, fica em torno de 800 tokens.
| Parte | Tokens | Sonnet 5.5 | Opus 5.5 |
|---|---|---|---|
| Instruções + planilha | 111.304 | US$ 0,2226 | US$ 0,4452 |
| Pergunta | 120 | US$ 0,00024 | US$ 0,00048 |
| Resposta (saída) | 800 | US$ 0,0080 | US$ 0,0160 |
| Primeira pergunta | US$ 0,2308 | US$ 0,4617 |
Aqui o peso está na entrada. Ao contrário de uma tradução, a resposta é curta e o arquivo é grande.
Passo 4: some a sessão inteira
A API não guarda a conversa. A cada nova pergunta, o pedido reenvia a planilha e todo o histórico. Nas 15 perguntas do caso, o histórico acumulado soma 96.600 tokens extras de entrada ao longo da sessão.
Sem cache, a planilha é cobrada pelo preço cheio 15 vezes. Com cache de prompt, ela é gravada no cache na primeira pergunta e lida com desconto nas seguintes, desde que as perguntas venham dentro do tempo de vida do cache (5 minutos no cache padrão, renovado a cada leitura).
| Modelo | Sessão sem cache | Sessão com cache | Economia | Com cache, em reais |
|---|---|---|---|---|
| Sonnet 5.5 | US$ 3,66 | US$ 0,75 | 79% | R$ 3,76 |
| Opus 5.5 | US$ 7,31 | US$ 1,50 | 79% | R$ 7,52 |
O cache faz a maior diferença deste guia. Para ele funcionar, a planilha e as instruções precisam vir no começo do pedido, sempre iguais, com as perguntas depois. Qualquer mudança no arquivo no meio da sessão desfaz o cache. Simule outras taxas de acerto na calculadora de cache de prompt.
Por que deixamos o Haiku 5.5 fora desta tabela? Com instruções e histórico, o último pedido da sessão chega a 124.304 tokens de entrada. No Haiku 5.5, um pedido acima de 100 mil tokens paga a faixa de preço mais alta, inclusive na parte lida do cache. Para arquivos desse tamanho, confira a faixa antes de escolher o modelo.
Passo 5: mande menos linhas
Muitas perguntas não precisam do arquivo bruto. "Qual região cresceu?" se responde com uma tabela de vendas por região e mês. Agregue antes, no próprio Excel, numa tabela dinâmica ou num script, e mande só o resumo.
No caso, um resumo de 200 linhas tem cerca de 5.490 tokens. A mesma sessão de 15 perguntas fica assim:
| Modelo | Sessão com o resumo, sem cache | Em reais |
|---|---|---|
| Haiku 5.5 | US$ 0,0263 | R$ 0,1319 |
| Sonnet 5.5 | US$ 0,5265 | R$ 2,6376 |
Com o arquivo menor, o Haiku 5.5 volta a ser opção, porque o pedido fica bem abaixo de 100 mil tokens. Guarde o arquivo bruto para as perguntas que precisam de linha a linha, como achar cadastros duplicados.
Passo 6: projete o mês
Se a analista faz uma sessão por dia útil, são 22 sessões no mês:
| Forma de enviar | Mês no Sonnet 5.5 | Em reais |
|---|---|---|
| Planilha inteira, sem cache | US$ 80,43 | R$ 402,92 |
| Planilha inteira, com cache | US$ 16,52 | R$ 82,76 |
| Resumo de 200 linhas | US$ 11,58 | R$ 58,03 |
Checklist antes de mandar uma planilha para a IA
- Tire as colunas que não importam. ID interno, carimbo de data com segundos e observações vazias também viram token.
- Prefira CSV a JSON. Em JSON, o nome de cada coluna se repete em cada linha. Em CSV, aparece uma vez no cabeçalho.
- Encurte os números. Um preço com seis casas decimais gasta mais tokens que o mesmo preço com duas.
- Explique as colunas uma vez. Um bom dicionário de colunas nas instruções evita respostas erradas e perguntas refeitas.
- Peça respostas curtas. Uma tabela de cinco linhas resolve a maioria das perguntas. Resposta longa é saída, e saída custa mais.
- Não cole dados pessoais sem necessidade. Nome, CPF e telefone de cliente raramente ajudam na análise. Tire antes de enviar.
Perguntas frequentes
Quantos tokens tem uma planilha de mil linhas?
Com 70 caracteres por linha, cerca de 27.451 tokens pela média do site. Planilhas com muitas colunas numéricas podem passar disso; confirme com uma amostra no contador de tokens.
Quanto custa uma pergunta sobre a planilha do caso?
A primeira pergunta custa US$ 0,2308 no Sonnet 5.5 e US$ 0,4617 no Opus 5.5. As seguintes ficam mais caras sem cache, porque o histórico cresce.
O cache de prompt vale a pena para planilhas?
No caso, sim: a sessão no Sonnet 5.5 cai de US$ 3,66 para US$ 0,75. Só funciona se as perguntas vierem em sequência, dentro do tempo de vida do cache.
Mandar o arquivo .xlsx em vez do CSV muda o custo?
Neste guia, a planilha entra como texto dentro do pedido, e o que muda o custo é quanto texto chega: colunas, linhas e casas decimais. Converter para CSV e limpar as colunas é o jeito mais simples de controlar isso. Ferramentas que abrem o .xlsx por código têm outra conta, fora deste guia.
Quanto fica por mês em reais?
Com uma sessão por dia útil e a planilha inteira com cache, cerca de R$ 82,76 no Sonnet 5.5. Mandando só o resumo, R$ 58,03.
Quer fazer a conta com a sua planilha? Cole uma amostra no contador de tokens e leve o total para a calculadora de custo de API de IA.
