Preços e Faturamento

Documentação mantida por 1ZheAI. Fontes e correções.

Encontrou um erro? Contate o suporte com o endereço da página e uma descrição. Não envie chaves de API ou credenciais de conta.

Entradas e saídas do Claude são cobradas com o desconto do respectivo modelo; leitura e gravação de cache são cobradas ao preço oficial cheio, sem desconto. O preço unitário e o desconto de cada modelo estão em Modelos e preços. Para GPT, MiMo e modelos de geração de imagens, consulte suas respectivas unidades de faturamento e cotações; os exemplos de tokens desta página referem-se ao Claude.

Quanto é cobrado por uma chamada

Cada chamada é cobrada separadamente por quatro categorias de tokens presentes no usage da resposta:

text

费用 = ( 输入 token      × 输入单价
       + 缓存写入 token  × 缓存写单价
       + 缓存读取 token  × 缓存读单价
       + 输出 token      × 输出单价 ) ÷ 1,000,000

输入单价、输出单价 = 对应官方单价 × 该模型折扣
缓存读取单价、缓存写入单价 = 对应官方原价

As quatro categorias de tokens correspondem aos campos da resposta:

Item de cobrança	Campo usage (nativo Anthropic)	Preço oficial relativo ao preço de entrada
Entrada	input_tokens	1×
Gravação de cache	cache_creation_input_tokens	1,25× (cache de 5 minutos), 2× (cache de 1 hora, "ttl": "1h")
Leitura de cache	cache_read_input_tokens	0,1× (Opus 5.5 e Sonnet 5.5: 0,05×; Fable 5.1: 0,025×)
Saída	output_tokens	Depende do modelo, veja a página de preços

Os multiplicadores oficiais de cache provêm da documentação Anthropic Prompt Caching. Neste site, o cache é cobrado pelo preço oficial correspondente, sem aplicar o desconto de entrada/saída novamente.

Os tokens de gravação do cache de 1 hora são registrados separadamente em cache_creation.ephemeral_1h_input_tokens e cobrados a 2 vezes o preço oficial de entrada, sem aplicar o desconto de entrada/saída. O preço unitário de gravação de cache listado na página de preços refere-se ao cache de 5 minutos.

Exemplo de cálculo

Os preços unitários abaixo são inteiros escolhidos aleatoriamente para demonstração e não correspondem a nenhum modelo específico; os preços unitários reais estão na página de preços.

Suponha que um modelo tenha os seguintes preços oficiais (por milhão de tokens): entrada $3, saída $15, gravação de cache $3,75, leitura de cache $0,30. O usage de uma requisição do Claude Code é:

json

{
  "input_tokens": 2000,
  "cache_creation_input_tokens": 1500,
  "cache_read_input_tokens": 30000,
  "output_tokens": 800
}

Pelo preço oficial:

Item	token	Preço unitário oficial	Custo oficial
Entrada	2.000	$3	$0,006
Gravação de cache	1.500	$3,75	$0,005625
Leitura de cache	30.000	$0,30	$0,009
Saída	800	$15	$0,012
Total			$0,032625

Suponha que, neste modelo de exemplo, entrada e saída tenham 20% do preço oficial (apenas para o exemplo, não representa o preço atual do modelo); então:

text

输入费用 = $0.006 × 0.2 = $0.0012
输出费用 = $0.012 × 0.2 = $0.0024
缓存费用 = $0.005625 + $0.009 = $0.014625
合计 = $0.018225

Não é possível multiplicar o custo oficial total pelo desconto de entrada/saída, pois a parte de cache não tem desconto.

Se a mesma requisição não acertar o cache, esses 30.000 tokens serão cobrados pelo preço de entrada com desconto do modelo. Para saber se há economia, é preciso comparar considerando o desconto do modelo, o custo de gravação do cache e o número de leituras repetidas — não basta comparar apenas os preços oficiais. O método de configuração e verificação está em Prompt Caching.

Faturamento do prompt de sistema

A API Claude provém de uma pool de contas de assinatura oficiais. Chamadas feitas pelo Claude Code não anexam conteúdo adicional. Outros clientes (SDK, curl e ferramentas de terceiros) anexam a cada requisição um prompt de sistema, cobrado como tokens de entrada: cerca de 350 tokens para Sonnet 4.6 e cerca de 500 tokens para a série 5.x. Essa parte é contabilizada junto com o conteúdo que você envia no usage da resposta, em input_tokens.

Teste real em 2026-10-15 enviando via curl a frase «Reply with just: ok»:

Modelo	Contagem count_tokens	input_tokens real	Prompt de sistema anexado (aprox.)
Sonnet 4.6	19	370	350 tokens
Série 5.x	18–19	510–530	cerca de 500 tokens

• count_tokens conta apenas o conteúdo que você envia, sem incluir esse prompt de sistema. Ao estimar custos com SDK, curl ou ferramentas de terceiros, some os valores da tabela acima; com o Claude Code não é necessário.
• Os tokens de entrada registrados nos logs de chamada já incluem essa parte; refaça o cálculo com a fórmula acima e o resultado deve coincidir com a cobrança nos logs.
• Quanto mais curta a requisição, maior a proporção dessa parte; em requisições com contexto longo, a proporção é muito pequena.

Saldo e moeda

• As cobranças são calculadas pelo algoritmo em dólares acima e debitadas do saldo da sua conta. O saldo é contabilizado em dólares.
• O valor principal recarregado é creditado em dólares; a taxa de processamento de pagamento é cobrada separadamente e não é reembolsável; as formas de pagamento disponíveis e os limites de valor regem-se pela página de pedido da carteira.

Como conferir descontos e custos

Primeiro verifique o desconto de entrada/saída do modelo e, em seguida, calcule separadamente entrada, saída, leitura de cache e gravação de cache. Cada cobrança pode ser recalculada no log de chamadas com o preço unitário correspondente.

Perguntas frequentes

Mesmo trabalho, por que ficou mais caro desta vez?

A causa mais comum é o cache não ter acertado: intervalo longo demais entre duas requisições (cache padrão de 5 minutos), alteração na primeira metade do contexto ou troca de modelo. Abra o log de chamadas e compare os tokens de leitura de cache das duas requisições para identificar.

O cache também tem desconto?

Não. Leitura e gravação de cache são cobradas ao preço oficial cheio; entrada e saída são cobradas com o desconto de cada modelo.

Por que input_tokens é maior do que o conteúdo que enviei?

Chamadas feitas pelo Claude Code não anexam conteúdo adicional. Outros clientes (SDK, curl e ferramentas de terceiros) anexam a cada requisição um prompt de sistema, cobrado como tokens de entrada: cerca de 350 tokens para Sonnet 4.6 e cerca de 500 tokens para a série 5.x. Os dados de teste estão em Faturamento do prompt de sistema.

Como conferir uma cobrança?

Localize essa cobrança no log de chamadas, substitua os quatro tipos de tokens e os preços unitários da página de preços na fórmula acima; o resultado deve coincidir com a cobrança nos logs. Se não coincidir, envie-nos a hora e o modelo desse registro de log.