SDK da OpenAI com base_url da xAI
Nesta página
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_urlparahttps://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,stopnos modelos de raciocínio,logit_bias) ou são ignorados (logprobsa partir dogrok-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