O SDK da OpenAI para o Grok
Nesta página
Atualizado a 3 de novembro de 2026, com base na página Models da xAI: o grok-4.7 (setembro de 2026) sucedeu ao grok-4.5 como modelo recomendado; o exemplo, escrito para o grok-4.5, funciona também com o grok-4.7. Fontes: Models · Release notes.
Esclarecido a 3 de novembro de 2026, com base na referência Chat Completions da xAI: a chamada não é estritamente idêntica à da OpenAI;
logprobsetop_logprobs(ignorados a partir dogrok-4.20) elogit_bias(não suportado) acrescentam diferenças às listadas abaixo. Fonte: xAI, Chat Completions.
Reutilize o que já sabe sobre a OpenAI
Se já trabalha com o SDK da OpenAI em Python, pode utilizá-lo tal como está para chamar a API do Grok. Basta redirecionar os pedidos para os servidores da xAI, alterando o URL base. Esta é a abordagem mais rápida se já dispuser de código existente.
Instalação
Caso o SDK da OpenAI ainda não esteja instalado no seu projeto:
pip install openai
Configurar o cliente para a xAI
A única diferença face à utilização habitual da OpenAI reside no parâmetro base_url:
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
É tudo. A partir daqui, todos os métodos do SDK da OpenAI funcionam com os modelos Grok.
Enviar uma mensagem
A chamada tem a mesma estrutura que para o GPT, exceto no que diz respeito aos parâmetros não suportados (ver abaixo):
response = client.chat.completions.create(
model="grok-4.5",
messages=[
{"role": "system", "content": "You are a technical assistant."},
{"role": "user", "content": "What's the difference between REST and GraphQL?"}
],
temperature=0.7,
max_completion_tokens=500
)
print(response.choices[0].message.content)
Modelos disponíveis
Basta substituir o nome do modelo da OpenAI por um modelo Grok:
grok-4.7: o modelo recomendado pela xAI, versátil, com entrada de imagem (ogrok-4.6e ogrok-4.5permanecem disponíveis)grok-4.20-0309-reasoning: raciocínio avançadogrok-4.3: respostas rápidas e económicas (contexto de 1M)
Migrar um projeto OpenAI existente
Para adaptar um projeto existente, tem duas opções.
Opção 1: Variáveis de ambiente
Altere as suas variáveis sem tocar no código:
export OPENAI_API_KEY="xai-your-key"
export OPENAI_BASE_URL="https://api.x.ai/v1"
O SDK da OpenAI lê estas variáveis automaticamente. O seu código existente funcionará se também alterar o nome do modelo e remover os parâmetros que a xAI não suporta.
Opção 2: Configuração explícita
Escreva uma função de inicialização que alterne entre fornecedores:
import os
from openai import OpenAI
def create_client(provider="xai"):
if provider == "xai":
return OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
return OpenAI() # OpenAI por predefinição
client = create_client("xai")
Esta abordagem permite-lhe alternar facilmente entre fornecedores durante a migração.
Diferenças a conhecer
Embora a API seja compatível, alguns comportamentos diferem:
- Os parâmetros
frequency_penaltyepresence_penaltynão são suportados nos modelos de raciocínio - O parâmetro
stopnão está disponível nos modelos de raciocínio logprobsetop_logprobssão silenciosamente ignorados pelos modelosgrok-4.20e superiores, elogit_biasnão é suportado- Os nomes dos modelos são, obviamente, diferentes
- Algumas funcionalidades da xAI (pesquisa no X, pesquisa na Web) não estão disponíveis através do formato padrão da OpenAI
Quando escolher esta abordagem
O modo de compatibilidade faz mais sentido quando o seu código existente importa mais do que funcionalidades exclusivas. O caso mais comum é a migração: código já escrito para a OpenAI passa para o Grok alterando o URL base e a chave: duas linhas, sem reescrita. A reversibilidade também conta: enquanto se mantiver no formato da OpenAI, mudar de fornecedor resume-se a uma questão de configuração, o que é valioso para comparar modelos ou negociar. Depois, há o ecossistema: ferramentas de terceiros construídas em torno do SDK da OpenAI, como o LangChain e o LlamaIndex, funcionam de imediato, e uma equipa que já conhece o SDK não tem nada de novo para aprender. O preço a pagar é o que viu acima: as funcionalidades específicas da xAI passam para segundo plano.
Pontos-chave
- Adicione
base_url="https://api.x.ai/v1"ao construtorOpenAI() - Substitua a chave da API e o nome do modelo
- As variáveis
OPENAI_BASE_URLeOPENAI_API_KEYpermitem uma migração sem tocar no código - Alguns parâmetros (penalizações, stop) não são suportados nos modelos de raciocínio