Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Preços dos Tokens

Aula 8 de 14 Atualizada a 2 de novembro de 2026 Iniciante
Nesta página
  1. Compreender a Faturação dos Modelos Grok
  2. Tabela de Preços Completa
  3. Os Quatro Tipos de Tokens
  4. Ler a Sua Fatura na Resposta da API
  5. O Tokenizador
  6. Tokens de Imagem de Entrada
  7. Pontos-chave

Compreender a Faturação dos Modelos Grok

Preços dos modelos na documentação 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):

ModeloContextoEntradaEntrada em CacheSaída
grok-4.7 (principal)500k$2.00$0.50$6.00
grok-4.6500k$2.00$0.50$6.00
grok-4.5500k$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-03091M$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.

75%
Desconto de Cache grok-4.7
85%
Desconto de Cache grok-4.5
84%
Desconto de Cache grok-4.3 e 4.20
×2
Tarifas Acima de 200k Tokens

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_ticks indica 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