Série Grok

Os modelos Grok da xAI, incluindo os modelos com reasoning Grok 4.7, 4.6, 4.5 e 4.3 e os modelos sem reasoning Grok 4.1 Fast e 4.20. São chamados pela API compatível com OpenAI.

Tarefas comuns

Modelos

A lista completa de modelos e os preços atualizados estão na página de modelos . O prefixo dos IDs de modelo é x-ai/ e pode ser omitido.

Suporte por endpoint

Os modelos Grok são fornecidos pela xAI oficial (grok); alguns modelos também contam com o provedor Azure AI Foundry.

Exemplos de chamada

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="x-ai/grok-4.7",
    reasoning_effort="low",
    messages=[{"role": "user", "content": "Explique em uma frase o que é idempotência."}],
)
print(resp.choices[0].message.content)
print("Tokens de reasoning:", resp.usage.completion_tokens_details.reasoning_tokens)

curl https://api.ofox.ai/v1/chat/completions \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "x-ai/grok-4.7",
    "reasoning_effort": "low",
    "messages": [{"role": "user", "content": "Explique em uma frase o que é idempotência."}]
  }'

Reasoning

Medição com o mesmo problema de matemática: por padrão, o Grok 4.7 usou cerca de 15 mil tokens de reasoning e levou cerca de 4 minutos; com reasoning_effort: "low", cerca de 4200 tokens e cerca de 1 minuto. Os tokens de reasoning são cobrados pelo preço de saída, e a quantidade aparece em usage.completion_tokens_details.reasoning_tokens; o conteúdo do reasoning vem em delta.reasoning_content nas respostas em streaming.

Outros recursos

• Entrada de imagens: suportada por Grok 4.3, 4.20 e 4.1 Fast, com o bloco de conteúdo padrão image_url. Veja como em Visão.
• Saída estruturada e chamada de ferramentas: response_format aceita json_schema; a chamada de ferramentas usa o parâmetro padrão tools.
• Cache: prefixos de requisição repetidos são armazenados em cache automaticamente; os acertos aparecem em usage.prompt_tokens_details.cached_tokens.

Erros comuns

Outros erros gerais em Tratamento de erros.

Documentação oficial

• xAI · Documentação 

Perguntas frequentes