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

SDK da OpenAI com base_url da xAI

Aula 5 de 12 Atualizada a 3 de novembro de 2026 Programador
Nesta página
  1. Utilizar o SDK da OpenAI para aceder ao Grok
  2. Configuração
  3. Chamadas idênticas às da OpenAI
  4. Streaming com o SDK da OpenAI
  5. JavaScript / TypeScript
  6. Alternar entre fornecedores
  7. O que não é transferido entre fornecedores
  8. Pontos-chave

Atualizado a 3 de novembro de 2026. De acordo com a referência de Chat Completions da xAI, a compatibilidade com o SDK da OpenAI não é «100%»: vários parâmetros não são suportados pelos modelos de raciocínio, são ignorados pelos modelos mais recentes ou não são suportados por nenhum modelo. Fonte: xAI, Chat Completions.

Utilizar o SDK da OpenAI para aceder ao Grok

Uma das principais vantagens do endpoint Chat Completions da xAI é a sua compatibilidade com o SDK da OpenAI. Pode utilizar o pacote openai que já conhece, bastando alterar o base_url para apontar para os servidores da xAI.

Esta abordagem é ideal se estiver a migrar uma aplicação existente da OpenAI para o Grok ou se pretender alternar entre fornecedores com alterações mínimas.

Configuração

A instalação é idêntica à de qualquer projeto que utilize o SDK da OpenAI:

pip install openai

A única diferença reside na criação do cliente, onde especifica o URL base e a chave de API da xAI:

from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1"
)

Os dois parâmetros essenciais são:

  • api_key: A sua chave de API da xAI (não uma chave da OpenAI)
  • base_url: https://api.x.ai/v1 — isto redireciona os pedidos para a xAI em vez da OpenAI

Chamadas idênticas às da OpenAI

Assim que o cliente estiver configurado, a utilização é a mesma que com o SDK padrão da OpenAI, exceto no que toca aos parâmetros que a xAI não suporta, detalhados abaixo:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1"
)

response = client.chat.completions.create(
    model="grok-4.20-0309-reasoning",
    messages=[
        {"role": "system", "content": "You are a technical assistant."},
        {"role": "user", "content": "What is the difference between TCP and UDP?"}
    ],
    temperature=0.7,
    max_tokens=1000
)

print(response.choices[0].message.content)

A única diferença visível é o nome do modelo: grok-4.20-0309-reasoning em vez de gpt-5.6, por exemplo.

Streaming com o SDK da OpenAI

O streaming funciona exatamente da mesma forma:

stream = client.chat.completions.create(
    model="grok-4.20-0309-reasoning",
    messages=[
        {"role": "user", "content": "Explain the concept of microservices."}
    ],
    stream=True
)

for chunk in stream:
    content = chunk.choices[0].delta.content
    if content:
        print(content, end="", flush=True)

JavaScript / TypeScript

O SDK da OpenAI para Node.js funciona da mesma maneira:

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.XAI_API_KEY,
  baseURL: "https://api.x.ai/v1",
});

const response = await client.chat.completions.create({
  model: "grok-4.20-0309-reasoning",
  messages: [
    { role: "system", content: "You are a helpful assistant." },
    { role: "user", content: "Hello, how are you?" },
  ],
});

console.log(response.choices[0].message.content);

Note que a propriedade é baseURL (U maiúsculo) em JavaScript, enquanto em Python é base_url.

Alternar entre fornecedores

A principal vantagem desta abordagem é a capacidade de mudar de fornecedor alterando apenas uma variável:

import os
from openai import OpenAI

provider = os.getenv("LLM_PROVIDER", "xai")

configs = {
    "xai": {
        "api_key": os.getenv("XAI_API_KEY"),
        "base_url": "https://api.x.ai/v1",
        "model": "grok-4.20-0309-reasoning"
    },
    "openai": {
        "api_key": os.getenv("OPENAI_API_KEY"),
        "base_url": "https://api.openai.com/v1",
        "model": "gpt-5.6"
    }
}

config = configs[provider]
client = OpenAI(api_key=config["api_key"], base_url=config["base_url"])

Esta arquitetura multi-fornecedor é comum em aplicações de produção que pretendem manter flexibilidade.

O que não é transferido entre fornecedores

Compatível não significa idêntico. A referência do endpoint da xAI assinala vários parâmetros que os modelos de raciocínio não suportam: frequency_penalty, presence_penalty (tal como no grok-3) e stop. Os parâmetros logprobs e top_logprobs são ignorados sem erro pelo grok-4.20 e modelos mais recentes, e o logit_bias não é suportado. O código que define estes parâmetros para a OpenAI terá de os remover para o Grok. Os campos ignorados silenciosamente são os mais complicados, pois nada indica que não têm qualquer efeito. As ferramentas alojadas também diferem entre fornecedores: a pesquisa web da OpenAI não é a da xAI. Por fim, a xAI classifica agora as Chat Completions como um endpoint legado e recomenda a API de Respostas (lições 11 e 12).

Pontos-chave

  • O SDK da OpenAI funciona com a xAI bastando alterar o base_url para https://api.x.ai/v1
  • Os métodos e formatos de resposta são iguais, mas alguns parâmetros não são suportados (frequency_penalty, presence_penalty, stop nos modelos de raciocínio, logit_bias) ou são ignorados (logprobs a partir do grok-4.20)
  • Adapte a chave de API, o nome do modelo e os parâmetros não suportados
  • Esta abordagem simplifica a migração a partir da OpenAI e permite alternar entre fornecedores
  • O streaming e a tipagem do SDK da OpenAI funcionam; as ferramentas alojadas são específicas de cada fornecedor