Preços dos Tokens
Nesta página
Compreender a Faturação dos Modelos Grok
A faturação dos modelos Grok segue um princípio simples: paga com base no volume de tokens processados. No entanto, por trás desta aparente simplicidade, existem vários mecanismos que precisa de dominar para controlar os seus custos: tokens de entrada, tokens de saída, cache automático e tokens de raciocínio.
Esta lição oferece-lhe uma visão completa da tabela de preços e dos mecanismos de faturação.
Tabela de Preços Completa
Tarifas por milhão de tokens, para pedidos com menos de 200.000 tokens de prompt (tarifas atualizadas a 2 de novembro de 2026):
| Modelo | Contexto | Entrada | Entrada em Cache | Saída |
|---|---|---|---|---|
| grok-4.7 (principal) | 500k | $2.00 | $0.50 | $6.00 |
| grok-4.6 | 500k | $2.00 | $0.50 | $6.00 |
| grok-4.5 | 500k | $2.00 | $0.30 | $6.00 |
| grok-4.3 (económico) | 1M | $1.25 | $0.20 | $2.50 |
| grok-4.20-0309 (raciocínio e não raciocínio) | 1M | $1.25 | $0.20 | $2.50 |
| grok-4.20-multi-agent-0309 | 1M | $1.25 | $0.20 | $2.50 |
| grok-build-0.1 (código) | 256k | $1.00 | $0.20 | $2.00 |
Quando o prompt atinge 200.000 tokens, a tabela transita para o nível superior e todas as três tarifas duplicam: o grok-4.7, por exemplo, passa para $4.00 na entrada, $1.00 na cache e $12.00 na saída.
Os Quatro Tipos de Tokens
Para compreender a sua fatura, deve distinguir quatro categorias de tokens:
Tokens de Entrada
São os tokens que envia para o modelo: prompt do sistema, mensagens do utilizador, contexto, documentos. Cada token não armazenado em cache é faturado à tarifa padrão de entrada.
Tokens em Cache
Quando envia um pedido que partilha um prefixo comum com um pedido anterior, os tokens já processados são recuperados da cache. Estes tokens em cache beneficiam de um desconto substancial na tarifa de entrada: 75% no grok-4.7 ($0.50 em vez de $2.00), 85% no grok-4.5 ($0.30), 84% no grok-4.3 e na geração 4.20 ($0.20 em vez de $1.25), 80% no grok-build-0.1.
A cache é totalmente automática — não precisa de configurar nada. Os tokens em cache aparecem no objeto usage da resposta.
Tokens de Saída
Tokens gerados pelo modelo na sua resposta visível. É o texto que recebe e exibe ao utilizador.
Tokens de Raciocínio
Exclusivos das variantes de raciocínio. Estes tokens representam o “pensamento” interno do modelo. São faturados à tarifa de saída, mas não aparecem na resposta visível. São rastreados separadamente em usage.completion_tokens_details.reasoning_tokens.
Ler a Sua Fatura na Resposta da API
Cada resposta da API contém um objeto usage detalhado. Eis como o interpretar:
{
"usage": {
"prompt_tokens": 5000,
"completion_tokens": 800,
"total_tokens": 5800,
"completion_tokens_details": {
"reasoning_tokens": 300
},
"cost_in_usd_ticks": 5000000000
}
}
O campo cost_in_usd_ticks indica o custo exato do pedido. A unidade é o “tick”: 10 mil milhões de ticks = 1 USD. Neste exemplo, 5.000.000.000 ticks = $0.50.
Existe também um campo alternativo cost_in_nano_usd: 1 mil milhão = 1 dólar.
O Tokenizador
Antes de enviar um pedido, pode estimar o número de tokens que irá consumir utilizando duas ferramentas:
- Consola Web:
console.x.ai/team/default/tokenizer— interface gráfica para testar os seus prompts - API de Tokenização: endpoint
/v1/tokenize-text— contagem programática
Isto é particularmente útil para estimar custos antes de lançar um processamento em lote sobre um grande volume de dados.
Tokens de Imagem de Entrada
Se enviar imagens para um modelo multimodal (Grok 4.5 ou a geração 4.20), cada imagem consome entre 256 e 1.792 tokens, dependendo do seu tamanho e do nível de detalhe solicitado. As imagens devem estar no formato JPG ou PNG, com um tamanho máximo de 20 MiB.
Estes tokens de imagem são faturados como tokens de entrada padrão.
Pontos-chave
- Quatro tipos de tokens: entrada, cache, saída, raciocínio
- A cache automática reduz a tarifa de entrada entre 75% (grok-4.7) e 85% (grok-4.5), dependendo do modelo
- As tarifas duplicam a partir de 200.000 tokens de prompt
- Os tokens de raciocínio são faturados à tarifa de saída
- O campo
cost_in_usd_ticksindica o custo exato (10 mil milhões = $1) - Utilize o tokenizador para estimar custos antes do processamento de volumes
- As imagens de entrada consomem entre 256 e 1.792 tokens, dependendo do tamanho