Custos e faturação das ferramentas
Nesta página
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