A fórmula
Qualquer calculadora de custo da API Claude, seja uma página web ou uma planilha, faz a mesma coisa:
custo = (tokens de entrada / 1,000,000) x taxa de entrada + (tokens de saída / 1,000,000) x taxa de saída
As taxas são a parte que você deve consultar. Para o Claude, leia a página de preços atual da Anthropic, pois as taxas variam por modelo e mudam com o tempo, e recursos como cache podem alterar a conta. Não as cito aqui. Para este endpoint, as taxas são fixas: $0,15 por 1M tokens de entrada e $0,50 por 1M tokens de saída. O crédito é pré-pago, nunca expira e requisições falhas ou recusadas não são cobradas.
Passo 1: estime seus tokens
Você precisa de quatro números por tarefa: requisições por mês, tokens médios de entrada, tokens médios de saída e um fator de retentativa. Algumas regras práticas ajudam quando você ainda não tem logs. Texto em inglês tem cerca de 4 caracteres por token, então uma página de 500 palavras equivale a aproximadamente 650 a 750 tokens. Prompts de sistema e histórico de chat contam como entrada em cada chamada. Para saída, use o comprimento solicitado mais cerca de 10%.
Uma vez que você tenha tráfego, pare de adivinhar. Cada resposta inclui um bloco usage com tokens de prompt e conclusão, e esta API também retorna o cabeçalho X-Balance-USD após cada chamada, permitindo que você acompanhe os gastos em tempo real.
Passo 2: três exemplos detalhados neste endpoint
Bot de suporte a rascunhos
20.000 conversas por mês, 1.200 tokens de entrada e 300 tokens de saída cada.
- Entrada: 20.000 x 1.200 = 24M tokens, 24 x $0,15 = $3,60
- Saída: 20.000 x 300 = 6M tokens, 6 x $0,50 = $3,00
- Total mensal: $6,60
Resumos de documentos
3.000 documentos por mês, 20.000 tokens de entrada e 800 tokens de saída cada.
- Entrada: 60M tokens x $0,15 = $9,00
- Saída: 2,4M tokens x $0,50 = $1,20
- Total mensal: $10,20
App de chat de ficção
100.000 rodadas por mês, 3.000 tokens de entrada e 300 tokens de saída cada.
- Entrada: 300M tokens x $0,15 = $45
- Saída: 30M tokens x $0,50 = $15
- Total mensal: $60
Para comparar com o Claude, insira suas taxas atuais nas mesmas linhas para as mesmas contagens de tokens. A diferença entre os dois totais é sua economia ou seu acréscimo por um modelo mais potente. Ambos são resultados legítimos. Este endpoint serve um único modelo de pesos abertos, uncensored, executado por um provedor independente. Não é o Claude nem um produto da Anthropic, então a pergunta certa é se sua qualidade é suficiente para sua tarefa.
Passo 3: um script que faz os cálculos com o uso real
Este script Python envia uma requisição e imprime o custo exato a partir dos números usage retornados. Altere as taxas para comparar qualquer provedor.
from openai import OpenAI
RATE_IN, RATE_OUT = 0.15, 0.50 # dollars per 1M tokens, this endpoint
client = OpenAI(base_url="https://api.claudeapicost.com/v1", api_key="YOUR_KEY")
def cost(usage, rate_in=RATE_IN, rate_out=RATE_OUT):
return usage.prompt_tokens / 1e6 * rate_in + usage.completion_tokens / 1e6 * rate_out
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Explain tokens in two sentences."}],
)
print(r.usage.prompt_tokens, r.usage.completion_tokens)
print(f"this call: ${cost(r.usage):.6f}")
# What the same call would cost at other rates, e.g. numbers from another pricing page:
# print(cost(r.usage, rate_in=YOUR_IN, rate_out=YOUR_OUT))
Para uma previsão mensal, multiplique o custo médio por chamada pela sua contagem de requisições. Adicione uma margem de segurança de 20 a 30% para crescimento e conversas mais longas.
Verificando o saldo pelo shell
Para ver os gastos sem código, leia o saldo antes e depois de um lote. O cabeçalho X-Balance-USD está em todas as respostas, e GET /v1/balance o retorna separadamente.
curl -s https://api.claudeapicost.com/v1/balance \
-H "Authorization: Bearer YOUR_KEY"
curl -si https://api.claudeapicost.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","max_tokens":50,"messages":[{"role":"user","content":"Hi"}]}' | grep -i x-balance
A diferença entre duas leituras, dividida pelo número de chamadas, é seu custo real por chamada.
O que planilhas esquecem
- Tokens de saída. Custam mais por token que a entrada aqui ($0,50 contra $0,15), e prompts com raciocínio complexo produzem respostas longas.
- Histórico. Um chat reenvia rodadas anteriores em cada chamada, então a entrada cresce com o comprimento da conversa.
- Retentativas. Chamadas falhas são gratuitas aqui, mas ainda custam seu tempo; recusas em outros lugares podem multiplicar o número real de chamadas.
- Picos. Limites de requisições importam: uma chave completa permite 8 requisições simultâneas e 300 por minuto.
- Recarga mínima. O crédito é comprado em valores inteiros de $20 a $500, então planeje sua primeira recarga.
O artigo mitos versus fatos de precificação detalha mais essas armadilhas.
Recarregando e testando antes
Recargas variam de $20 a $500, qualquer valor inteiro, com +5% a partir de $50, +10% a partir de $100 e +15% a partir de $200. Pague com cripto (USDT na TRC20, USDC na Base). Veja a página de preços para a tabela completa.
Para testar sua estimativa em prompts reais, solicite a trial de $0.50 na página de chave. Ela dura 7 dias, não precisa de cartão e é uma por pessoa. A documentação lista os campos de uso e códigos de erro. Se você receber 429, excedeu o limite de requisições ou concorrência, então reduza a velocidade ou tente novamente após o valor Retry-After.

