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

Custos e faturação das ferramentas

Aula 3 de 16 Atualizada a 30 de julho de 2026 Programador
Nesta página
  1. Compreender a faturação das ferramentas do Grok
  2. Estrutura de faturação em duas partes
  3. Cenários de custos cumulativos
  4. Estratégias de otimização de custos
  5. Comparação com SDKs
  6. Pontos-chave

Compreender a faturação das ferramentas do Grok

A utilização de ferramentas integradas na API do Grok gera custos adicionais para além do consumo padrão de tokens. Compreender esta estrutura de faturação é essencial para prever as suas despesas e otimizar a sua integração.

Estrutura de faturação em duas partes

Cada chamada de ferramenta é faturada de duas formas:

1. Consumo de tokens

As ferramentas consomem tokens como qualquer outra interação com o modelo. Os tokens de entrada incluem o seu prompt, as definições das ferramentas e o contexto da conversa. Os tokens de saída incluem a resposta do modelo e os resultados das ferramentas.

Os resultados de pesquisa (web ou X) adicionam um volume significativo de tokens de entrada, pois o modelo recebe excertos das páginas ou publicações encontradas. Quanto mais numerosos ou detalhados forem os resultados, maior será o consumo de tokens.

2. Custo por invocação

Para além dos tokens, cada chamada de ferramenta é faturada a uma taxa fixa de 5 USD por 1.000 invocações, ou 0,005 USD por chamada. Esta taxa é idêntica para as três ferramentas principais:

  • Pesquisa Web: 0,005 USD por pesquisa
  • Pesquisa X: 0,005 USD por pesquisa
  • Execução de Código: 0,005 USD por execução

Este custo é faturado por chamada de ferramenta, independentemente do número de resultados devolvidos ou da complexidade da execução.

Cenários de custos cumulativos

O modelo pode efetuar múltiplas chamadas de ferramentas para um único pedido do utilizador. Eis alguns cenários comuns:

Pedido simples (1 chamada)

Um utilizador solicita as últimas notícias sobre um tópico específico. O modelo realiza uma única pesquisa na web. Custo adicional: 0,005 USD + tokens para os resultados.

Pedido complexo (múltiplas chamadas)

Um utilizador solicita uma análise comparativa que requer dados da web e um cálculo. O modelo realiza uma pesquisa na web e, em seguida, utiliza a Execução de Código para processar os dados. Custo adicional: 0,010 USD + tokens para ambos os resultados.

Pedido iterativo (chamadas sucessivas)

O modelo considera os resultados iniciais insuficientes e refina a sua pesquisa com uma segunda chamada à web. Custo adicional: 0,010 USD para ambas as pesquisas.

Estratégias de otimização de custos

Seja preciso nos seus prompts

Um prompt ambíguo leva o modelo a realizar múltiplas pesquisas para cobrir diferentes interpretações possíveis. Um prompt preciso reduz o número de chamadas.

Ative apenas as ferramentas necessárias

Se o seu caso de utilização requer apenas pesquisa na web, não adicione a Pesquisa X ou a Execução de Código ao array tools. O modelo poderia utilizá-las desnecessariamente.

Utilize a filtragem por domínio

Para a Pesquisa Web, os parâmetros allowed_domains e excluded_domains limitam o âmbito da pesquisa. Resultados mais direcionados significam menos iterações.

Monitore a sua utilização

A consola da xAI permite-lhe acompanhar os seus custos em tempo real. Configure alertas de faturação para evitar despesas excessivas, especialmente durante a fase de desenvolvimento, quando os testes se podem acumular.

Comparação com SDKs

A faturação é idêntica independentemente do SDK utilizado (xAI SDK, OpenAI SDK, Vercel AI SDK ou cURL direto). Os custos dependem apenas do número de invocações e dos tokens consumidos, não do método de acesso.

Pontos-chave

  • A faturação combina tokens (consumo padrão) e invocações (0,005 USD por chamada)
  • A taxa é uniforme: 5 USD por 1.000 chamadas, independentemente da ferramenta
  • O modelo pode efetuar múltiplas chamadas por pedido, multiplicando os custos
  • Prompts precisos e filtragem adequada reduzem chamadas desnecessárias
  • A consola da xAI permite monitorizar o consumo em tempo real