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

Ilustração de uma chave digital representando a geração da chave da API do Grok no console 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.

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.

  1. 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.
  2. Crie a chave na página API Keys. O endereço documentado é console.x.ai/team/default/api-keys. O default no caminho é o time padrão da conta. Copie a chave assim que ela for gerada e guarde em local seguro.
  3. 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 prefixo api-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.

  4. 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 .env na pasta do projeto:

    XAI_API_KEY=your_api_key

    Nunca cole a chave direto no código. Coloque o .env no .gitignore para ele ficar fora do repositório:

    .env

    Erro 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.

  5. 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:
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.

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:

ModeloTamanho do promptEntradaEntrada em cacheSaída
grok-4.7abaixo de 200 mil tokensUS$ 2,00US$ 0,50US$ 6,00
grok-4.7a partir de 200 mil tokensUS$ 4,00US$ 1,00US$ 12,00
grok-build-0.1abaixo de 200 mil tokensUS$ 1,00US$ 0,20US$ 2,00
grok-build-0.1acima de 200 mil tokensUS$ 2,00US$ 0,40US$ 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 .

Encontre outros guias no YouTube da Hora de Codar.

Escrito por | Matheus Battisti

Matheus Battisti
Fundador da Hora de Codar

Programador apaixonado pelo mundo das tecnologias, sempre buscando em aprender e se aprofundar em linguagens, frameworks e o que mais for necessário para executar um bom trabalho. Agora tem uma nova missão que é de passar seu conhecimento adiante para formar novos programadores e especializar mais os que já são.

Formações

Formação Vibe Coding

Formação Vibe Coding

Do Prompt ao Produto: Crie Software Real com IA

  • 474 aulas
  • 20 projetos
  • 39h 30min

Blog | Mais populares