API do Grok: chaves, endpoints, modelos e uma primeira requisição

O que é a API do Grok

A API do Grok é a interface paga para desenvolvedores da SpaceXSI (antiga xAI). Ela dá ao seu próprio código acesso à mesma família de modelos Grok que move os apps do Grok, além de modelos de imagem, vídeo e voz. Você paga por token, por imagem, por segundo de vídeo ou por minuto de áudio.

A API é separada dos planos para consumidores. A página de preços da The X Subscription lista “Grok API access” no Plus, mas também diz que o uso da API é cobrado à parte. A SpaceXSI não explica como as duas coisas se relacionam, então conte com pagar as chamadas à API com créditos do console.

Os principais casos de uso são os de sempre: chat e raciocínio nos seus próprios apps, agentes que chamam ferramentas, compreensão de documentos e imagens, e geração de mídia. Para uma definição simples, veja o verbete API no nosso glossário.

Como obter uma chave da API do Grok

O guia rápido da SpaceXSI descreve quatro passos:

1. Crie uma conta em console.x.ai.
2. Carregue créditos pré-pagos. A documentação diz que os créditos são necessários para as chamadas funcionarem.
3. Abra a página API Keys e gere uma chave.
4. Guarde a chave como variável de ambiente chamada XAI_API_KEY, e não no seu código-fonte.

A cobrança é pré-paga por padrão. Quando os créditos acabam, as requisições são recusadas. Você pode ativar a recarga automática, que tem mínimo de $5. A cobrança por fatura vem desativada por padrão e precisa ser solicitada à equipe de vendas da SpaceXSI.

URL base, SDKs e endpoints

Todas as requisições vão para a URL base https://api.x.ai/v1. A documentação lista três formas de chamá-la:

• xai_sdk, o SDK oficial para Python.
• O SDK da OpenAI (Python e JavaScript), apontado para a URL base da xAI.
• O Vercel AI SDK, pelo pacote @ai-sdk/xai.

Responses API ou Chat Completions

A Responses API, em /v1/responses, é a interface principal da SpaceXSI. O Chat Completions, em /v1/chat/completions, continua com suporte. Com o Grok 4.7, as chamadas à Responses API sempre retornam o raciocínio criptografado. O endpoint antigo /v1/completions foi substituído pelo /v1/chat/completions.

Os endpoints no estilo Anthropic estão obsoletos

Os endpoints compatíveis com a Anthropic, /v1/messages e /v1/complete, estão marcados como obsoletos. A SpaceXSI indica a Responses API ou o gRPC no lugar deles. Não há data de desativação, mas projetos novos não devem ser construídos sobre eles.

Endpoint regional dos EUA

Um endpoint nos EUA, em https://us.api.x.ai/v1, mantém a inferência nos Estados Unidos. Ele custa 1,1x as tarifas globais e só atende o grok-4.7 e o grok-4.6. Os detalhes estão na nossa página de preços da API do Grok.

Uma primeira requisição mínima

Este exemplo chama a Responses API com curl. Ele parte do princípio de que sua chave está guardada em XAI_API_KEY:

curl https://api.x.ai/v1/responses -H "Authorization: Bearer $XAI_API_KEY" -H "Content-Type: application/json" -d '{"model": "grok-4.7", "input": "Explain a context window in one sentence."}'

Duas configurações valem a pena conhecer desde o primeiro dia:

• reasoning_effort: o Grok 4.7 aceita low, medium, high (o padrão) ou xhigh.
• prompt_cache_key (ou o cabeçalho x-grok-conv-id): a SpaceXSI recomenda fortemente definir um. Sem ele, uma requisição pode cair em um servidor sem cache e pagar o preço cheio de entrada.

Os nomes dos campos podem mudar. Confira a referência de requisições na documentação oficial antes de publicar.

Modelos na API do Grok

Estes são os modelos de texto atuais, com preços em dólares americanos por 1M de tokens. Prompts com mais de 200 mil tokens custam o dobro.

O Grok 4.7 Fast não está na API pública. Ele só é oferecido no Cursor e no Grok Build. Vários modelos mais antigos, incluindo grok-3, grok-4-0709, Grok 4 Fast e grok-code-fast-1, foram aposentados em 15 de maio de 2026. As chamadas ao grok-code-fast-1 agora são direcionadas ao grok-build-0.1.

A API também atende os modelos de imagem e vídeo do Grok Imagine e os modelos do Grok Voice. Veja Grok Imagine e o guia da API do Grok Voice.

Ferramentas integradas

Os modelos do Grok podem chamar ferramentas no servidor que a SpaceXSI roda para você. A página de preços lista:

• Web Search e Image Search.
• X Search, que retorna posts e perfis do X.
• Code Execution.
• Busca em arquivos anexados e Collections Search para recuperação nos seus próprios documentos.
• Ferramentas view_image, view_x_video e Remote MCP, cobradas apenas pelos tokens.

A maioria das ferramentas é cobrada por 1.000 chamadas, além do custo dos tokens. Cada modelo também tem limites de requisições e tokens por nível, explicados na nossa página de limites de requisição da API do Grok.

Perguntas frequentes