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

O SDK da OpenAI para o Grok

Aula 6 de 14 Atualizada a 3 de novembro de 2026 Programador
Nesta página
  1. Reutilize o que já sabe sobre a OpenAI
  2. Instalação
  3. Configurar o cliente para a xAI
  4. Enviar uma mensagem
  5. Migrar um projeto OpenAI existente
  6. Diferenças a conhecer
  7. Quando escolher esta abordagem
  8. Pontos-chave

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; logprobs e top_logprobs (ignorados a partir do grok-4.20) e logit_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 (o grok-4.6 e o grok-4.5 permanecem disponíveis)
  • grok-4.20-0309-reasoning: raciocínio avançado
  • grok-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_penalty e presence_penalty não são suportados nos modelos de raciocínio
  • O parâmetro stop não está disponível nos modelos de raciocínio
  • logprobs e top_logprobs são silenciosamente ignorados pelos modelos grok-4.20 e superiores, e logit_bias nã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 construtor OpenAI()
  • Substitua a chave da API e o nome do modelo
  • As variáveis OPENAI_BASE_URL e OPENAI_API_KEY permitem uma migração sem tocar no código
  • Alguns parâmetros (penalizações, stop) não são suportados nos modelos de raciocínio