Como Usar a API Grok 4.5?

O Grok 4.5 foi lançado em 8 de julho de 2026, e o caminho da API é a maneira mais rápida de colocá-lo para funcionar. O ID do modelo é grok-4.5, o preço é de US$ 2 por milhão de tokens de entrada e US$ 6 por milhão de saída, e a janela de contexto é de 500 mil tokens. O anúncio da xAI o posiciona para codificação, tarefas de agente e trabalho de conhecimento com capacidade, nas palavras de Musk, "classe Opus".

Este guia o orienta sobre como obter uma chave, fazer sua primeira chamada, escolher entre grok-4.5 e o mais antigo grok-4.3, e testar o endpoint corretamente no Apidog antes de enviar qualquer coisa que dependa dele.

Uma nota sobre a disponibilidade antes de começar: o Grok 4.5 ainda não está disponível na UE, nem nos produtos nem no console da API. A xAI espera o acesso na UE em meados de julho de 2026.

Passo 1: Obtenha uma chave de API xAI

1. Vá para o console da xAI e faça login.
2. Abra a seção Chaves de API e crie uma nova chave.
3. Armazene-a como uma variável de ambiente. Nunca a codifique diretamente:

export XAI_API_KEY="xai-..."

Contas de console novas receberam créditos de teste no passado (relatos variam de US$ 25 a US$ 150). Verifique sua página de cobrança em vez de contar com um valor específico. Se você quiser explorar sem créditos, veja como usar o Grok 4.5 gratuitamente.

Passo 2: Faça sua primeira requisição

O início rápido oficial da xAI usa o endpoint de Respostas. Este é o formato exato da página de lançamento:

curl -s https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.5",
    "input": "Find and fix the bug, then explain it: function median(a){a.sort();return a[a.length/2]}"
  }'

Dois detalhes confundem as pessoas:

• O ID do modelo contém um ponto. grok-4.5 funciona; grok-4-5 retorna um erro de modelo não encontrado. Slugs e URLs usam hífens, chamadas de API usam o ponto.
• O início rápido tem formato de Respostas, aceitando um campo input em vez de um array messages. A xAI também mantém completações de chat compatíveis com OpenAI, o que é importante se você estiver migrando um código existente.

Usando o SDK da OpenAI

Como a xAI mantém compatibilidade com as bibliotecas cliente da OpenAI, apontar um cliente existente para https://api.x.ai/v1 geralmente é uma mudança de uma única linha. Este é o mesmo padrão que abordamos para modelos anteriores em nosso guia de API do Grok 4.3:

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["XAI_API_KEY"],
    base_url="https://api.x.ai/v1",
)

response = client.chat.completions.create(
    model="grok-4.5",
    messages=[
        {"role": "system", "content": "You are a code review assistant."},
        {"role": "user", "content": "Review this handler for race conditions: ..."},
    ],
)
print(response.choices[0].message.content)

Verifique a documentação da xAI para a superfície atual dos parâmetros. Os recursos se movem rapidamente nas primeiras semanas após um lançamento, e a documentação é a fonte da verdade para chamadas de ferramentas e saídas estruturadas.

Streaming

Para uso interativo, ative o streaming e consuma eventos enviados pelo servidor:

stream = client.chat.completions.create(
    model="grok-4.5",
    messages=[{"role": "user", "content": "Refactor this function step by step: ..."}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

O Grok 4.5 entrega cerca de 80 tokens por segundo, território de modelos rápidos, então os streams parecem responsivos mesmo em saídas longas.

Passo 3: Escolha o ID do modelo correto

A xAI agora vende dois modelos de chat principais, e a troca entre eles é incomum:

O novo modelo custa mais e possui metade do contexto. O que você ganha em troca é capacidade e eficiência: no SWE Bench Pro, o Grok 4.5 resolve tarefas com uma média de 15.954 tokens de saída, cerca de 4,2x menos que o Claude Opus 4.8 (máx) no mesmo benchmark. Para loops de agente, menos tokens de saída significam contas mais baixas e tempos de espera menores.

Regra geral: RAG de documentos longos e análise de contexto gigante permanecem no grok-4.3; codificação de várias etapas e uso de ferramentas de agente passam para o grok-4.5. A matemática completa dos custos, incluindo como a eficiência de tokens muda a comparação, está em Grok 4.5: preço explicado.

Se você preferir rotear através de um agregador para failover ou faturamento unificado, o Grok 4.5 também está listado no OpenRouter. Abordamos esse padrão de configuração em como usar modelos Grok via OpenRouter.

Passo 4: Teste o endpoint no Apidog

Antes que o Grok 4.5 chegue perto da produção, coloque o endpoint sob um sistema de teste adequado. Aqui está o fluxo de trabalho no Apidog:

1. Crie uma requisição para POST https://api.x.ai/v1/responses (ou o caminho de completações de chat se você estiver usando a superfície compatível).
2. Armazene a chave como uma variável de ambiente em um ambiente Apidog, para que o token Bearer nunca caia em uma coleção compartilhada.
3. Envie e inspecione. O Apidog renderiza os streams SSE à medida que chegam, para que você possa observar os deltas e confirmar que o stream termina de forma limpa.
4. Afirme sobre a resposta. Adicione asserções visuais nos campos dos quais seu aplicativo depende, como o nome do modelo ecoado de volta, motivo de conclusão e contagens de uso.
5. A/B os dois modelos. Duplique a requisição, mude grok-4.5 para grok-4.3 e compare a qualidade da saída, latência e uso de tokens lado a lado em seus prompts reais, em vez de confiar nas médias de benchmark.
6. Simule. Gere um servidor de simulação a partir do esquema de resposta para que suas equipes de frontend e QA construam contra um formato estável enquanto você ajusta os prompts. Nenhum crédito xAI queimado no desenvolvimento da UI.

O objeto de uso importa mais com este modelo do que com a maioria. A proposta do Grok 4.5 é a eficiência de tokens, então rastreie output_tokens por tarefa em suas asserções. Se seus prompts produzirem saídas com comprimento de Opus de qualquer forma, a vantagem de custo diminui.

Baixe o Apidog gratuitamente se quiser acompanhar; todo o fluxo acima funciona no plano gratuito.

Custos, limites e pegadinhas

• Preços: US$ 2/M de entrada, US$ 6/M de saída. As chamadas de ferramentas de pesquisa na Web e no X são cobradas separadamente a US$ 5 por 1.000 chamadas. O processamento prioritário é cobrado a 2x as taxas padrão.
• Entrada em cache: fontes secundárias relatam uma taxa de US$ 0,50/M para entrada em cache, mas nem a página de lançamento nem a página de preços da documentação confirmam isso em 9 de julho. Verifique o console antes de construir modelos de custo com base em cache.
• Nenhum desconto por lote é listado para grok-4.5, ao contrário de grok-4.3.
• UE: bloqueado até meados de julho de 2026. As requisições de contas faturadas na UE falham no nível do console, não no nível da API, então isso aparece como um problema de acesso em vez de um código de erro.
• Limites de taxa dependem do nível da conta. Os padrões dos níveis de limite de taxa anteriores do Grok ainda se aplicam: verifique seu nível de console e construa um recuo antes de precisar.

Para ter uma visão mais ampla do que este modelo é e onde ele supera ou fica atrás do Opus 4.8, comece com o que é o Grok 4.5.

FAQ

Qual é o ID do modelo da API do Grok 4.5? grok-4.5. O ponto é obrigatório nas chamadas de API.

A API do Grok 4.5 funciona com o SDK da OpenAI? Sim. Defina base_url como https://api.x.ai/v1 e passe sua chave xAI. O código existente de completações de chat migra com alterações mínimas.

Quanto custa a API do Grok 4.5? US$ 2 por milhão de tokens de entrada e US$ 6 por milhão de tokens de saída, sem desconto por lote listado. Veja a análise completa de preços para a matemática do custo efetivo.

Existe uma maneira gratuita de chamar o Grok 4.5? Grok Build e Cursor incluem uso gratuito do Grok 4.5 por um tempo limitado, e os créditos de teste do console cobriram testes leves de API. Detalhes em nosso guia de acesso gratuito.

Qual é a janela de contexto? 500 mil tokens. Se você precisar de 1 milhão, use grok-4.3 e aceite a troca de capacidade.