Como gerar a chave da API do Grok no console oficial da xAI

A chave oficial da API do Grok é criada no console da xAI, em console.x.ai: você cria a conta, carrega créditos e gera a chave na página API Keys. Ela nasce sem permissão nenhuma, então você precisa liberar endpoints e modelos (as ACLs) antes da primeira chamada funcionar.
Esse é o caminho oficial para quem vai programar com o Grok. Chave comprada de revendedor fica fora do controle de permissões e da cobrança do seu time. Se você procura os recursos pagos dentro do app, o assunto é outro. Aqui o foco é a API.
xAI, SpaceXAI ou SpaceXSI: onde fica o console oficial hoje
O console continua em console.x.ai e a API continua em https://api.x.ai/v1. As chaves ainda se chamam xAI API keys, mesmo com a troca de nome da empresa, como mostram as Release Notes da documentação.
A troca de nome aconteceu em duas etapas. A SpaceX comprou a xAI, junto com o Grok e o X, em fevereiro de 2026, e a empresa passou a se chamar SpaceXAI, segundo o Engadget. Em 4 de outubro de 2026, Musk anunciou o nome SpaceXSI, e o perfil no X já virou @SpaceXSI, segundo a Tesla North.
Na documentação, a mudança aparece nos títulos das páginas de docs.x.ai, que já trazem SpaceXSI. Os domínios não mudaram.
Isso importa na hora de reconhecer o site legítimo. Se alguém oferecer um "console novo da SpaceXSI" em outro domínio, desconfie, porque o endereço documentado segue sendo x.ai. A mesma lógica vale para o app, e o post sobre o logo oficial do Grok ajuda a identificar a versão verdadeira.

Black Week do Nexus
A formação de IA mais completa do Brasil
- 7 formações · 112 cursos · 26 mil alunos
O que você precisa antes de gerar a chave da API do Grok
Você precisa de uma conta no console da xAI com créditos carregados. Esse é o primeiro passo do quickstart oficial.
A cobrança funciona de duas formas, segundo a página de Billing:
- Créditos pré-pagos: são atribuídos ao time que você escolhe no momento da compra.
- Fatura mensal por consumo: o uso entra na conta do mês.
As duas formas funcionam juntas. O custo de cada requisição é calculado na hora e sai dos créditos. Se os créditos acabarem, o valor vai para a fatura mensal.
A compra de créditos e o saldo ficam em Billing → API spend management, onde também dá para usar código promocional. As faturas ficam em Billing → Invoices.
Se você vai usar o SDK oficial em Python, precisa do Python 3.10 ou superior, conforme o repositório xai-sdk-python.
Passo a passo: criar e configurar a chave da API do Grok
O fluxo tem cinco etapas: conta e créditos, criação da chave, permissões, armazenamento seguro e uma chamada de teste. Se pular as permissões ou o armazenamento seguro, a chave não funciona ou vaza.
- Crie a conta e carregue créditos. Entre em
console.x.ai, crie a conta e compre créditos em Billing → API spend management. Sem créditos ou fatura ativa, não tem como cobrar as requisições. - Crie a chave na página API Keys. O endereço documentado é
console.x.ai/team/default/api-keys. Odefaultno caminho é o time padrão da conta. Copie a chave assim que ela for gerada e guarde em local seguro. - Conceda as ACLs. Que ACL? É a lista de permissões da chave. Pela documentação da Management API, uma chave da xAI não tem acesso a nada por padrão. Você libera cada endpoint com o prefixo
api-key:endpoint:seguido do nome do endpoint, e cada modelo com o prefixoapi-key:model:seguido do nome do modelo.Para liberar tudo o que o time tem, existem os curingas:
api-key:endpoint:* api-key:model:*O curinga é prático, mas abre todos os modelos e endpoints do time. Para uma chave que vai rodar só um projeto, liberar apenas o modelo e o endpoint que ele usa limita o estrago se ela vazar.
Erro comum deste passo: criar a chave e ir direto para o código. Sem ACL, a primeira chamada falha, e muita gente acha que o problema está no SDK quando a chave só não tem permissão.
- Guarde a chave na variável
XAI_API_KEY. A documentação mostra duas formas. No terminal:export XAI_API_KEY="your_api_key"Ou num arquivo
.envna pasta do projeto:XAI_API_KEY=your_api_keyNunca cole a chave direto no código. Coloque o
.envno.gitignorepara ele ficar fora do repositório:.envErro comum deste passo: commitar o
.env. Se a chave já foi para um repositório público, apagar o arquivo depois não resolve, porque ela continua no histórico do Git. Gere uma chave nova no console e descarte a antiga. - Faça a primeira chamada de verificação. A xAI documenta que a API do Grok funciona com o SDK da OpenAI: basta trocar a chave e a base URL. O exemplo abaixo usa a Responses API com o modelo
grok-4.7:

VPS Hostinger para seu sistema
10% OFF extraVPS com SSD NVMe e backups semanais. O cupom MATHEUSHORADECODAR é aplicado automaticamente pelo link.
Ver planos com 10% OFF →import os
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1",
)
response = client.responses.create(
model="grok-4.7",
input="Explique em uma frase o que é uma variável de ambiente.",
)
print(response.output_text)
Se preferir o SDK oficial da xAI, a instalação e a leitura da chave ficam assim:
pip install xai-sdk
import os
from xai_sdk import Client
client = Client(api_key=os.getenv("XAI_API_KEY"))
Os métodos de chamada do xai-sdk estão no repositório oficial, e vale conferir lá a versão atual antes de copiar exemplo de terceiros.
Como checar o resultado: a chamada precisa devolver uma resposta em texto no terminal, e o débito correspondente precisa aparecer no saldo em Billing → API spend management. Se apareceram os dois, a chave, as ACLs e a cobrança estão funcionando.

Crie sistemas com IA para vender
Prompts, modelos e checklists para criar e publicar seu sistema com IA e preparar a oferta para o primeiro cliente.
Quero o e-book gratuito Receba o livro e os bônus no seu e-mail.Como usar a chave do Grok em ferramentas de código
A chave serve em dois cenários documentados: o Grok Build, que é o agente de programação no terminal, e qualquer código ou ferramenta que aceite o SDK da OpenAI com base URL customizada.
Grok Build no terminal
O Grok Build se instala por script oficial. No macOS e no Linux:
curl -fsSL https://x.ai/cli/install.sh | bash
No Windows (PowerShell):
irm https://x.ai/cli/install.ps1 | iex
Depois, entre na pasta do projeto e rode grok.
O login padrão abre o navegador. Em servidor sem interface gráfica, script ou pipeline de CI/CD, a documentação recomenda passar a chave pela variável de ambiente antes de rodar grok:
export XAI_API_KEY="xai-..."
A configuração persistente fica em ~/.grok/config.toml.
Código e ferramentas compatíveis com o SDK da OpenAI
Se a ferramenta deixa você trocar a chave e a base URL, aponte para https://api.x.ai/v1 com a sua XAI_API_KEY. A xAI recomenda o SDK da OpenAI por ser o mais estável. Se você conhece a ideia de trocar só a connection string de um banco e manter o resto do código, aqui é parecido: o código fica igual e só o destino muda.
Para quem chama a API direto por HTTP, o endpoint da Responses API do Grok 4.7 é https://api.x.ai/v1/responses.
Tome cuidado com o SDK da Anthropic. A xAI descontinuou totalmente a compatibilidade com ele. Se você tem código antigo apontando o SDK da Anthropic para a API da xAI, a orientação oficial é migrar para a Responses API, o SDK da OpenAI ou gRPC.
A documentação da xAI não lista integrações oficiais com editores e extensões de terceiros. Antes de usar uma delas, confira na documentação da própria ferramenta se ela aceita base URL customizada.
Qual modelo escolher e quanto custa por milhão de tokens
Para programação, agentes e texto em geral, a xAI indica o grok-4.7, lançado em 21 de setembro de 2026, segundo o guia do Grok 4.7. Ele tem janela de contexto de 500.000 tokens, aceita texto e imagem na entrada e responde em texto. O grok-build-0.1 é o modelo voltado para programação e sai mais barato por token.
Preços por milhão de tokens, conforme a tabela oficial de preços:
| Modelo | Tamanho do prompt | Entrada | Entrada em cache | Saída |
|---|---|---|---|---|
| grok-4.7 | abaixo de 200 mil tokens | US$ 2,00 | US$ 0,50 | US$ 6,00 |
| grok-4.7 | a partir de 200 mil tokens | US$ 4,00 | US$ 1,00 | US$ 12,00 |
| grok-build-0.1 | abaixo de 200 mil tokens | US$ 1,00 | US$ 0,20 | US$ 2,00 |
| grok-build-0.1 | acima de 200 mil tokens | US$ 2,00 | US$ 0,40 | US$ 4,00 |
Repare que o preço dobra quando o prompt passa de 200 mil tokens. Em agente que carrega o repositório inteiro no contexto, essa faixa chega rápido.
O endpoint regional dos EUA (https://us.api.x.ai/v1) cobra 1,1 vez a tabela padrão, segundo a página de endpoints regionais. No grok-4.7, abaixo de 200 mil tokens, isso dá US$ 2,20 de entrada, US$ 0,55 em cache e US$ 6,60 de saída.
E lembre que a chave só acessa o modelo se a ACL dele foi concedida. Trocou grok-4.7 por grok-build-0.1 no código e começou a falhar? Confira primeiro a permissão do modelo.
Próximo passo depois de gerar a chave
Antes de plugar a chave num agente ou num pipeline, confira se as ACLs liberam só o que o projeto usa, rode a chamada de teste e veja o débito aparecer em Billing → API spend management. Se as três coisas batem, a chave está pronta para uso contínuo.
Uma chave vendida fora do console não passa por nada disso. Você não controla quais modelos ela acessa nem acompanha o gasto dela no seu time.
Fontes consultadas
Consulta em .
Formações
Formação Vibe Coding
Do Prompt ao Produto: Crie Software Real com IA
- 474 aulas
- 20 projetos
- 39h 30min
Blog | Mais populares
Grok é grátis? Como usar a IA do Elon Musk sem pagar
Grok grátis existe e dá pra usar sem cartão. Veja o que está liberado no plano gratuito, os limites de uso e quando vale migrar para o SuperGrok ou Heavy.
Grok tem limite de uso? Como funcionam as cotas de mensagens e recursos
Grok tem limite de uso no plano gratuito com cotas dinâmicas de ~10 mensagens a cada 2 horas. Entenda como funciona o throttling e o que muda nos planos pagos.
Grok premium apk ou SuperGrok: qual é o caminho oficial para os recursos pagos do Grok?
Quem busca grok premium apk deve saber: esse não é o caminho oficial. Veja como assinar o SuperGrok, preços em dólar e os recursos pagos do Grok.
