Como Usar a API Grok 4.5?

O Grok 4.5 foi lançado em 8 de julho de 2026, e a API é o caminho mais direto para colocar o modelo em produção. O ID correto é grok-4.5, o preço anunciado é US$ 2 por milhão de tokens de entrada e US$ 6 por milhão de tokens de saída, com janela de contexto de 500 mil tokens. No anúncio, a xAI posiciona o modelo para codificação, agentes e trabalho de conhecimento com capacidade, nas palavras de Musk, “classe Opus”.

Experimente o Apidog hoje

Neste guia, você vai configurar a chave da xAI, fazer a primeira chamada, escolher entre grok-4.5 e grok-4.3, testar o endpoint no Apidog e validar a resposta antes de conectar o modelo ao seu app.

Observação de disponibilidade: o Grok 4.5 ainda não está disponível na UE, nem nos produtos nem no console da API. A xAI espera liberar acesso na UE em meados de julho de 2026.

Passo 1: Obtenha uma chave de API da xAI

1. Acesse o console da xAI e faça login.
2. Abra a seção de chaves de API.
3. Crie uma nova chave.
4. Salve a chave como variável de ambiente.

Nunca coloque a chave diretamente no código-fonte:

export XAI_API_KEY="xai-..."

Se você usa .env, mantenha o arquivo fora do Git:

XAI_API_KEY=xai-...

E adicione ao .gitignore:

.env

Contas novas do console receberam créditos de teste no passado, com relatos variando de US$ 25 a US$ 150. Não dependa de um valor fixo: confira a página de billing no console. Se quiser explorar sem créditos, veja como usar o Grok 4.5 gratuitamente.

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

O quickstart oficial da xAI usa o endpoint de Responses. A chamada mínima fica assim:

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]}"
  }'

Valide dois pontos antes de debugar qualquer outra coisa:

• O ID do modelo é grok-4.5, com ponto. grok-4-5 retorna erro de modelo não encontrado.
• O endpoint /v1/responses usa input, não messages.

Se você já tem código usando a API de chat compatível com OpenAI, também pode usar o formato de chat completions.

Usando o SDK da OpenAI com a API da xAI

A xAI mantém compatibilidade com bibliotecas cliente da OpenAI. Na prática, você troca o base_url para https://api.x.ai/v1 e usa sua chave da xAI.

Exemplo em Python:

import os
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)

Esse é o mesmo padrão usado em modelos anteriores, como mostramos no guia de API do Grok 4.3.

Confira a documentação da xAI para parâmetros atualizados. Chamadas de ferramentas, saídas estruturadas e comportamento de streaming podem mudar rapidamente nas primeiras semanas após o lançamento.

Streaming

Para interfaces interativas, ative stream=True e processe os chunks conforme chegam:

import os
from openai import OpenAI

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

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, então o streaming tende a parecer responsivo mesmo em respostas longas.

Passo 3: Escolha entre grok-4.5 e grok-4.3

A xAI mantém dois modelos principais de chat com trade-offs diferentes:

Critério	grok-4.5	grok-4.3
Janela de contexto	500 mil tokens	1 milhão de tokens
Preço por 1M de tokens	US$ 2 entrada / US$ 6 saída	US$ 1,25 entrada / US$ 2,50 saída
Desconto por lote	Nenhum listado	20% de desconto
Velocidade	~80 TPS	Mais lento segundo o posicionamento da xAI
Melhor uso	Codificação agente, eficiência de tokens	Contexto longo, custo menor

O grok-4.5 custa mais e tem metade da janela de contexto do grok-4.3. Em troca, a xAI posiciona o modelo como mais capaz e mais eficiente em tokens. No SWE Bench Pro, o Grok 4.5 resolve tarefas com média de 15.954 tokens de saída, cerca de 4,2x menos que o Claude Opus 4.8, máximo, no mesmo benchmark.

Regra prática:

• Use grok-4.3 para RAG com documentos muito longos, análise de grandes bases de texto e casos que exigem 1 milhão de tokens de contexto.
• Use grok-4.5 para codificação em múltiplas etapas, agentes com ferramentas e tarefas onde reduzir tokens de saída melhora custo e latência.

A matemática completa de custo está em Grok 4.5: preço explicado.

Se você preferir rotear por um agregador para failover ou billing unificado, o Grok 4.5 também aparece no OpenRouter. O padrão de configuração está em como usar modelos Grok via OpenRouter.

Passo 4: Teste o endpoint no Apidog

Antes de conectar o Grok 4.5 à produção, teste o contrato da API, streaming, autenticação e campos de resposta no Apidog.

Fluxo recomendado:

1. Crie uma requisição POST para:

https://api.x.ai/v1/responses

1. Configure os headers:

Authorization: Bearer {{XAI_API_KEY}}
Content-Type: application/json

1. Use um body mínimo:

{
  "model": "grok-4.5",
  "input": "Explain the bug in this JavaScript function: function median(a){a.sort();return a[a.length/2]}"
}

1. Salve XAI_API_KEY como variável de ambiente no Apidog, não dentro da coleção.

2. Envie a requisição e inspecione:

   • status code;
   • payload retornado;
   • campos de uso;
   • motivo de finalização;
   • comportamento em streaming, se aplicável.

3. Adicione asserções para os campos dos quais seu app depende.

Exemplos de validações úteis:

• o status deve ser 200;
• o modelo retornado deve corresponder ao esperado;
• a resposta não deve vir vazia;
• os campos de uso devem existir;
• o stream deve finalizar corretamente.

1. Faça um A/B entre modelos:

   • duplique a requisição;
   • troque grok-4.5 por grok-4.3;
   • rode os mesmos prompts;
   • compare qualidade, latência e tokens consumidos.

2. Gere um mock server a partir do esquema de resposta. Assim, frontend e QA conseguem desenvolver contra um contrato estável sem gastar créditos da xAI durante ajustes de UI.

O objeto de uso é especialmente importante no Grok 4.5. A proposta do modelo depende de eficiência de tokens, então acompanhe output_tokens por tarefa. Se seus prompts gerarem saídas longas demais, a vantagem de custo pode diminuir.

Você pode baixar o Apidog gratuitamente para reproduzir esse fluxo. Ele funciona no plano gratuito.

Custos, limites e pegadinhas

Antes de ir para produção, valide estes pontos:

• Preço: US$ 2/M de tokens de entrada e US$ 6/M de tokens de saída.
• Ferramentas de pesquisa: chamadas de pesquisa na Web e no X são cobradas separadamente a US$ 5 por 1.000 chamadas.
• Processamento prioritário: cobrado a 2x as taxas padrão.
• Entrada em cache: fontes secundárias relatam 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 confirmavam isso em 9 de julho. Verifique o console antes de montar projeções de custo baseadas em cache.
• Desconto por lote: nenhum desconto por lote está listado para grok-4.5, ao contrário de grok-4.3.
• UE: acesso bloqueado até meados de julho de 2026. Requisições de contas faturadas na UE falham no nível de acesso do console, não como erro específico da API.
• Rate limits: dependem do nível da conta. O padrão dos níveis anteriores de rate limit do Grok ainda vale como referência: confira seu nível no console e implemente retry com backoff antes de precisar.

Exemplo simples de retry com backoff em Python:

import time
from openai import OpenAI

def call_with_retry(client: OpenAI, payload: dict, max_attempts: int = 3):
    for attempt in range(max_attempts):
        try:
            return client.chat.completions.create(**payload)
        except Exception:
            if attempt == max_attempts - 1:
                raise

            sleep_seconds = 2 ** attempt
            time.sleep(sleep_seconds)

Para uma visão mais ampla do modelo e de onde ele supera ou fica atrás do Opus 4.8, veja 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 use sua chave da xAI. Código existente de chat completions tende a migrar com poucas mudanças.

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 calcular custo efetivo.

Existe uma forma gratuita de chamar o Grok 4.5?

Grok Build e Cursor incluem uso gratuito do Grok 4.5 por tempo limitado, e créditos de teste do console já cobriram testes leves de API. Veja os detalhes em nosso guia de acesso gratuito.

Qual é a janela de contexto?

500 mil tokens. Se você precisa de 1 milhão de tokens, use grok-4.3 e aceite o trade-off de capacidade.