O que é uma API compatível com a OpenAI? Como mudar de fornecedor numa linha

Mudar numa linha

Por predefinição, os SDKs da OpenAI enviam pedidos para a OpenAI, mas aceitam um URL base. Aponte-o para outro fornecedor e use a chave e os nomes dos modelos desse fornecedor; o resto do código mantém-se.

from openai import OpenAI
client = OpenAI(
    base_url="https://api.zurelay.com/v1",  # the only line that changes
    api_key="YOUR_ZURELAY_KEY",
)
reply = client.chat.completions.create(
    model="claude-sonnet-5-5",
    messages=[{"role": "user", "content": "Hello"}],
)
print(reply.choices[0].message.content)

O mesmo funciona em TypeScript com baseURL, e em ferramentas que pedem um "URL base da OpenAI" ou "endpoint personalizado": OpenCode, Continue, Cline, Open WebUI e muitas outras. Os guias de integração incluem as definições de cada uma. Muitas ferramentas também leem as variáveis de ambiente OPENAI_BASE_URL e OPENAI_API_KEY, pelo que a mudança não exige qualquer código.

URLs base dos principais fornecedores

O URL base termina normalmente em /v1, e o SDK acrescenta-lhe /chat/completions. Alguns fornecedores usam outros caminhos, por isso copie-os exatamente:

O URL de cada fornecedor, com um ID de modelo e o que cada endpoint disponibiliza, consta da lista de URLs base compatíveis com a OpenAI, consultada na documentação de cada fornecedor em 26 de outubro de 2026.

O que se mantém

• Mensagens, prompts de sistema e streaming.
• Chamadas de ferramentas e saída estruturada com um esquema JSON.
• Imagens e outros ficheiros na mensagem, para os modelos que os conseguem ler.
• O bloco de utilização, para que a contabilização de tokens funcione da mesma forma.

O que verificar antes de mudar

• Nomes dos modelos. Cada fornecedor tem os seus próprios IDs; liste-os com GET /v1/models.
• Que APIs disponibiliza. Muitos fornecedores disponibilizam Chat Completions, mas não as APIs Responses, Realtime, embeddings ou batch da OpenAI. A Zurelay disponibiliza Chat Completions, imagens, vídeo e voz, e a API Messages da Anthropic para Claude.
• Parâmetros adicionais. Os níveis de raciocínio, os controlos de cache e os limites de amostragem variam consoante o modelo. Um bom fornecedor documenta os parâmetros que cada modelo aceita.
• É mesmo o modelo anunciado? Por vezes, os fornecedores mais baratos disponibilizam um modelo mais antigo ou mais barato com um nome mais recente. Encontra cinco verificações rápidas em o que as APIs de IA baratas realmente vendem.

Quando a mudança falha

• 404 Not Found. O URL base inclui o endpoint (.../v1/chat/completions) ou não contém o caminho específico do fornecedor. Use apenas o URL base.
• 401 Unauthorized. A chave pertence a outro fornecedor ou, no Model Studio da Alibaba, a outra região.
• Modelo não encontrado. Os IDs de um mesmo modelo variam entre fornecedores: claude-opus-5-5 na Anthropic, anthropic/claude-opus-5 no OpenRouter, o nome da sua implementação no Azure.
• 400 num parâmetro. Alguns fornecedores rejeitam ou ignoram parâmetros que a API da OpenAI aceita, como response_format na camada de compatibilidade da Anthropic. Remova-o ou mude para um fornecedor que o aceite.

APIs compatíveis com a Anthropic

O Claude Code e os SDKs da Anthropic usam, por sua vez, a API Messages da Anthropic e leem ANTHROPIC_BASE_URL. Vários fornecedores também disponibilizam essa API, incluindo DeepSeek, Moonshot, Z.ai, MiniMax e Zurelay; os respetivos URLs nunca terminam em /v1. A lista inclui-os, e preços do Claude Code compara o custo do Claude Code em cada plano e através da API.

Porquê mudar

Uma única chave compatível com a OpenAI dá acesso a modelos de vários laboratórios. Assim, para comparar Claude, GPT, Gemini e DeepSeek com os seus próprios prompts, basta mudar o nome do modelo, tal como para passar para um mais barato. Consulte os modelos e preços.