Quatro Tipos de Tokens
Nesta página
Compreenda a faturação de tokens
A fatura da API Grok não é simplesmente o volume multiplicado pelo preço. Coexistem quatro tipos de tokens, cada um com as suas próprias regras de contagem e tarifa, e duas aplicações que consomem o mesmo total de tokens podem pagar valores muito diferentes. Ler esta desagregação é essencial para estimar um orçamento antes do lançamento — e para compreender, uma vez em produção, de onde provém uma rubrica descontrolada.
Tokens de texto e a disparidade entre entrada e saída
Os tokens de texto constituem a maior parte do volume: tudo o que envia — prompt do sistema, histórico da conversa, mensagem do utilizador — e tudo o que o modelo produz em resposta. No grok-4.5, a entrada é faturada a 2,00 USD por milhão de tokens e a saída a 6,00 USD por milhão. No grok-4.3, estes valores descem para 1,25 USD e 2,50 USD por milhão.
Lembre-se da proporção: a saída custa consistentemente mais do que a entrada, por um fator de três no grok-4.5. Gerar texto exige mais capacidade de computação do que ler o contexto, e a grelha de preços reflete esta assimetria. A consequência prática é contra intuitiva: adicionar mil tokens de exemplos ao seu prompt do sistema custa frequentemente menos do que deixar o modelo produzir mil tokens de verborreia supérflua. Uma instrução de concisão bem colocada é, por vezes, a melhor alavanca de poupança de custos numa aplicação inteira.
Tokens de imagem
Uma imagem enviada para a API é convertida em tokens antes da análise. A contagem varia de 256 tokens para uma miniatura de baixa resolução até 1.792 tokens para uma imagem de alta definição, dependendo do tamanho e do nível de detalhe. Estes tokens são faturados à tarifa de entrada de texto, o que facilita a avaliação da compensação: cada imagem pesada equivale, na sua fatura, a cerca de mil e quinhentas palavras de prompt.
Incorpore, portanto, este reflexo no pipeline a montante da chamada. Redimensione sistematicamente para a resolução mínima que o seu caso de uso exige, aplique uma compressão JPEG razoável e pare de enviar imagens 4K quando uma imagem standard for suficiente para responder à pergunta. Num serviço que processa milhares de fotos por dia, este simples redimensionamento reduz a fatura visual sem degradar a qualidade da resposta. Note as restrições de formato no processo: apenas são aceites JPG e PNG, até 20 MiB por ficheiro.
Tokens em cache
Os tokens em cache são tokens de entrada que o sistema de cache automático da API já memorizou durante uma chamada anterior. São faturados a uma tarifa fortemente reduzida: 0,30 USD por milhão no grok-4.5 em vez de 2,00 USD, uma poupança de cerca de 85%, e 0,20 USD por milhão no grok-4.3 em vez de 1,25 USD.
O mecanismo que desencadeia este caching será abordado na próxima secção do curso. Por agora, saiba apenas onde o ler: o campo cached_tokens no objeto usage devolvido com cada resposta indica quantos dos seus tokens de entrada beneficiaram da tarifa reduzida. Esta é a primeira métrica a instrumentar se quiser gerir os seus custos a sério.
Tokens de raciocínio
O quarto tipo diz respeito a modelos que pensam antes de responder, como a variante grok-4.20-0309-reasoning. Os tokens de raciocínio correspondem a esta deliberação interna, produzida antes da resposta visível.
É aqui que se esconde a surpresa de faturação mais frequente: estes tokens são contados à tarifa de saída, não de entrada. No grok-4.5, isso representa 6,00 USD por milhão. Como o raciocínio pode mobilizar vários milhares de tokens numa questão complexa, a parte invisível da resposta excede por vezes a parte visível. Acrescente um detalhe que confunde frequentemente as equipas: o grok-4.20-0309 não devolve o conteúdo do raciocínio (reasoning_content) em texto claro na resposta da API. Paga por uma cadeia de pensamento que não consegue ler. Isto não é razão para excluir o raciocínio, mas sim para o ativar apenas onde ele altera verdadeiramente a qualidade do resultado.
Preços a partir de 5 de agosto de 2026 — os preços evoluem regularmente: antes de qualquer cálculo orçamental, consulte a grelha atual na página oficial de modelos e preços da xAI.
Pontos-chave
- Existem quatro tipos de tokens: texto, imagem, em cache (tarifa reduzida) e raciocínio (faturado como saída)
- Os tokens de imagem variam de 256 a 1.792 consoante o tamanho e o detalhe da imagem
- Os tokens em cache oferecem cerca de 85% de poupança no grok-4.5
- Os tokens de raciocínio são faturados à tarifa de saída, o que pode representar um custo significativo
- Escolha o modelo certo para a sua necessidade: o grok-4.3 custa significativamente menos que o grok-4.5, tanto para entrada como para saída