Ir para o conteúdo principal
Português— Escolher um idioma
Menu

API da xAI e compatibilidade com a OpenAI

Aula 4 de 14 Atualizada a 29 de julho de 2026 Programador
Nesta página
  1. Uma API familiar
  2. Configuração mínima
  3. Obter uma chave de API
  4. Endpoints disponíveis
  5. Limitações de compatibilidade
  6. Pontos-chave

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:

  1. URL base: substitua https://api.openai.com/v1 por https://api.x.ai/v1
  2. 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

  1. Aceda a console.x.ai
  2. Inicie sessão com a sua conta xAI (ou crie uma em accounts.x.ai)
  3. Na secção de Chaves de API (API Keys), gere uma nova chave
  4. 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/completions com stream: true: transmissão em fluxo (streaming) com reasoning_content
  • /v1/chat/completions com tools: 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/v1 e é 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