API da xAI e compatibilidade com a OpenAI
Nesta página
Uma API familiar
A API da xAI utiliza o mesmo formato que a API da OpenAI. Se já trabalhou com a API da OpenAI ou com ferramentas compatíveis, não tem nada de novo para aprender. A única coisa que muda é o URL base.
https://api.x.ai/v1
Esta compatibilidade é uma escolha estratégica da xAI. Em vez de impor um novo formato proprietário, adotaram o padrão de facto da indústria. Como resultado, qualquer ferramenta, SDK ou editor que suporte a API da OpenAI pode utilizar imediatamente o grok-build-0.1.
Configuração mínima
Para mudar da OpenAI para a xAI em qualquer cliente compatível, só precisa de alterar dois parâmetros:
- URL base: substitua
https://api.openai.com/v1porhttps://api.x.ai/v1 - Chave de API: utilize a sua chave de API da xAI (obtida em
console.x.ai)
Todo o resto — formato das mensagens, parâmetros de temperatura, estrutura da resposta — é idêntico.
Exemplo com o SDK Python da OpenAI
from openai import OpenAI
client = OpenAI(
api_key="your-xai-key",
base_url="https://api.x.ai/v1"
)
response = client.chat.completions.create(
model="grok-build-0.1",
messages=[
{"role": "system", "content": "You are a programming assistant."},
{"role": "user", "content": "Write a quicksort function in Python."}
]
)
Utiliza o SDK padrão da OpenAI sem quaisquer modificações. Apenas o base_url e o nome do modelo mudam.
Exemplo com curl
curl https://api.x.ai/v1/chat/completions \
-H "Authorization: Bearer your-xai-key" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-build-0.1",
"messages": [
{"role": "user", "content": "Explain the difference between let and const in JavaScript"}
]
}'
Obter uma chave de API
- Aceda a console.x.ai
- Inicie sessão com a sua conta xAI (ou crie uma em accounts.x.ai)
- Na secção de Chaves de API (API Keys), gere uma nova chave
- Copie-a imediatamente — não voltará a ser mostrada
Mantenha esta chave segura. Nunca a inclua num repositório Git nem a partilhe em chats de equipa. Utilize uma variável de ambiente ou um gestor de segredos.
Endpoints disponíveis
O grok-build-0.1 suporta os seguintes endpoints, todos no formato da OpenAI:
/v1/chat/completions: geração de texto e código (o mais utilizado)/v1/chat/completionscomstream: true: transmissão em fluxo (streaming) comreasoning_content/v1/chat/completionscomtools: chamada nativa de ferramentas
Limitações de compatibilidade
Existem algumas diferenças menores:
- Os modelos disponíveis são os da xAI (grok-build-0.1, grok-4.5, etc.), não os da OpenAI
- Alguns parâmetros específicos da OpenAI (como
logprobs) podem não ser suportados - O
reasoning_contenté específico da API da xAI e não existe na API da OpenAI
Pontos-chave
- A API da xAI está em
https://api.x.ai/v1e é compatível com o formato da OpenAI - Só precisa de alterar o URL base e a chave de API para migrar
- O SDK Python da OpenAI funciona tal como está
- Obtenha a chave de API em console.x.ai
- Todos os editores compatíveis com a OpenAI funcionam com a xAI