Como os tokens são contados

Veja como tokens de entrada e saída são contados e cobrados, como funciona o desconto do cache de prompt e como estimar o custo antes de enviar.

Tokens são a unidade em que o Claude (e qualquer outro LLM) mede o trabalho. Cerca de 4 caracteres de texto em inglês — e, mais ou menos, o que você paga.

Todos os modelos, recursos e preços Índice da documentação para agentes de IA: https://oneprovider.dev/docs/llms.txt

Regra prática

1 token ≈ 4 caracteres em inglês ≈ 0,75 palavra.
Uma página de prosa (~500 palavras) tem ~670 tokens.
Código-fonte, alfabetos não latinos e emojis geram tokens mais densos — espere de 1,2 a 2× a taxa do inglês.
Uma janela de contexto de 200 mil tokens equivale a cerca de 150 mil palavras em inglês — umas 300 páginas.

Quatro tipos de token na cobrança

Dados de referência

Tipo	O que é	Como é cobrado
Input	Todo token que o modelo lê: prompt de sistema, turnos anteriores, mensagem atual do usuário, schema das ferramentas, imagens.	Taxa cheia de entrada.
Output	Todo token que o modelo escreve: texto da resposta, chamadas de ferramentas, raciocínio (se ativado).	Taxa cheia de saída (em geral 5× a de entrada).
Cache read	Tokens de entrada atendidos a partir do ponto de cache de uma requisição anterior.	10% da taxa de entrada na maioria dos modelos; as taxas exatas de cada modelo estão na tabela de modelos .
Cache write	A primeira requisição em um ponto de cache — cria o cache para leituras futuras.	125% da taxa de entrada na maioria dos modelos; as taxas exatas de cada modelo estão na tabela de modelos .

Toda resposta traz essas contagens no campo usage — veja Consumo e cobrança .

Estimar antes de enviar

Os SDKs da Anthropic oferecem um auxiliar de contagem de tokens que você pode executar localmente:

python

from anthropic import Anthropic
client = Anthropic(base_url="https://api.oneprovider.dev")
count = client.messages.count_tokens(
model="claude-sonnet-5-5",
messages=[{"role": "user", "content": "Your long prompt here"}],
)
print(count.input_tokens)

A contagem é um limite inferior — ela não inclui a saída que o modelo está prestes a escrever. Para orçar, adicione um teto de max_tokens e considere o pior caso.

Como estimar a economia com cache

Não existe um multiplicador universal entre os modelos. Para o modelo equilibrado atual claude-sonnet-5-5 ou qualquer outro, use os valores separados de Leitura de cache e Gravação em cache da tabela de taxas gerada. Compare-os com a taxa de entrada do modelo escolhido e com o número esperado de leituras repetidas.

O preço de uma requisição O topo de /pricing precifica uma requisição de exemplo linha a linha: entrada, leitura de cache e saída na taxa de cada modelo — os mesmos números da tabela de Taxas .

Respostas rápidas

Qual base URL devo usar?

O Claude Code e os SDKs da Anthropic usam https://api.oneprovider.dev. Os SDKs da OpenAI e os clientes compatíveis com a OpenAI usam https://api.oneprovider.dev/v1. Uma única chave funciona nos dois; a lista de modelos está na página de modelos e os preços, na página de preços .

Como me autentico?

Envie a chave sk-… pura em x-api-key ou em Authorization: Bearer: um dos dois, nunca ambos. Guarde a chave em uma variável de ambiente, não em um arquivo que vai para o commit. Mais sobre autenticação .

Onde consigo uma chave?

Abra o seu painel no bot do Telegram @oneprovider_robot ou em app.oneprovider.dev, recarregue o saldo e toque em “Emitir chave”. Cada chave pode ter o seu próprio limite de gastos. Painel e chaves de API .

O que significam 401, 404 e 429?

401: a chave está ausente, foi digitada errado ou enviada no cabeçalho errado; cole a chave inteira, sem aspas nem espaços. 404: em geral, uma base URL errada, por exemplo um /v1 ausente ou duplicado. 429 com “Insufficient balance”: o saldo do painel ou o limite de gastos da chave acabou, então recarregue em vez de tentar de novo; qualquer outro 429 é um limite de requisições, então aguarde o tempo de Retry-After. Detalhes: códigos de erro e solução de problemas .

Por que os streams são cortados ou reiniciados?

VPNs e proxies VLESS costumam armazenar SSE em buffer ou quebrar a negociação do HTTP/2. A OneProvider não tem restrições regionais e não armazena streams em buffer; desative o proxy e tente de novo.

Onde pergunto se isso não bastar?

Escreva para @Oneproviderhelpbot no Telegram ou abra “Suporte” no painel web, informando o código de status HTTP e a mensagem de erro exata. Como funciona o suporte .

Última atualização: 2026-11-08 Encontrou um erro? @Oneproviderhelpbot