BroadRouter
Começar

Base URL de APIs compatíveis com a OpenAI: 14 provedores conferidos

Pela equipe da BroadNet Inference · 6 min de leitura · Publicado em

Uma API compatível com a OpenAI permite manter o SDK da OpenAI e trocar só duas coisas: a base_url e a chave de API. A base URL muda de provedor para provedor, por exemplo https://api.groq.com/openai/v1 para a Groq, https://openrouter.ai/api/v1 para o OpenRouter e https://inference.broadnet.ai/v1 para a BroadNet Inference. Caminhos, IDs de modelo e parâmetros aceitos continuam diferentes, então teste uma requisição antes de trocar.

Uma API compatível com a OpenAI aceita requisições no mesmo formato da API da OpenAI, então os SDKs oficiais da OpenAI funcionam depois que você troca a base_url e a chave de API. A parte difícil é que cada provedor coloca o endpoint em um lugar um pouco diferente. A tabela abaixo lista 14, cada um lido na documentação do próprio provedor em 15 de novembro de 2026.

Qual é a base URL de cada provedor compatível com a OpenAI?

Provedor Base URL O que a documentação de compatibilidade com a OpenAI lista Particularidades informadas na documentação
OpenAI https://api.openai.com/v1 Tudo; é a referência Padrão do SDK quando nada é definido
Anthropic https://api.anthropic.com/v1/ Chat completions “Primarily intended to test and compare model capabilities” (tradução: destinada principalmente a testar e comparar as capacidades dos modelos); strict ignorado; entradas de áudio e arquivo retornam 400
Google Gemini https://generativelanguage.googleapis.com/v1beta/openai/ Chat completions, embeddings, geração de imagens, models, batch Suporte à biblioteca da OpenAI “still in beta” (tradução: ainda em beta); Responses API não listada
DeepSeek https://api.deepseek.com Chat completions Sem caminho de versão; URL separada no formato Anthropic em /anthropic
Groq https://api.groq.com/openai/v1 Chat completions, Responses API; observações sobre transcrição de áudio logprobs, logit_bias, top_logprobs, messages[].name retornam 400; n precisa ser 1; sem transcrições srt ou vtt
Together AI https://api.together.ai/v1 Chat, completions, imagens, síntese de voz, transcrições, models, Responses Inferência só nos EUA em https://us-api.together.ai/v1; embeddings só em endpoints dedicados
Fireworks AI https://api.fireworks.ai/inference/v1 Chat completions IDs de modelo como accounts/fireworks/models/…; reduz max_tokens para caber no contexto em vez de dar erro, salvo instrução contrária
DeepInfra https://api.deepinfra.com/v1/openai Chat completions; clientes da Responses usam a mesma base Embeddings, imagens e voz documentados em outra página
Mistral AI https://api.mistral.ai/v1 POST /v1/chat/completions A referência da API não se declara compatível com a OpenAI; teste antes de depender disso
OpenRouter https://openrouter.ai/api/v1 Chat completions Cabeçalhos opcionais HTTP-Referer e X-OpenRouter-Title para os rankings dele
xAI https://api.x.ai/v1 Responses API O guia diz “The Responses API is the preferred way of interacting with our models” (tradução: a Responses API é a forma preferida de interagir com nossos modelos)
Z.ai (GLM) https://api.z.ai/api/paas/v4/ Chat completions Caminho v4, não v1
Alibaba Model Studio https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 (Singapura) Chat completions ID do workspace no host; a chave só funciona na região em que foi criada, senão 401
BroadNet Inference https://inference.broadnet.ai/v1 Chat completions, transcrições de áudio IDs de modelo começam com broadnet/; veja abaixo

A Alibaba também lista um endpoint nos EUA (Virgínia) em us-east-1. A linha de Pequim na mesma página mostra o host de Singapura, enquanto outro trecho da página cita cn-beijing, então confirme um endpoint na China pelo console. A tabela é um retrato do momento. Endpoints mudam: as documentações da Anthropic e do Google redirecionaram para novos endereços enquanto conferíamos.

Para os preços desses provedores, veja as páginas de preços de API de LLM por provedor.

Como definir a base URL no código?

Em Python, passe base_url para o cliente:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)
r = client.chat.completions.create(
    model="broadnet/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": "Say hello in one line."}],
)
print(r.choices[0].message.content)

Em Node, a opção é baseURL:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://inference.broadnet.ai/v1",
  apiKey: process.env.BROADNET_API_KEY,
});

Ou defina uma vez para todas as ferramentas que usam os SDKs oficiais. No código-fonte do SDK Node, baseURL assume por padrão process.env['OPENAI_BASE_URL'] e, na falta dela, https://api.openai.com/v1; o README do Python documenta a mesma variável:

export OPENAI_BASE_URL="https://inference.broadnet.ai/v1"
export OPENAI_API_KEY="your-key"

Passo a passo completo: SDK Python da OpenAI, SDK Node da OpenAI. Para entender o que é uma base URL e por que as ferramentas pedem isso, veja o glossário.

Como testar uma nova base URL com curl?

Envie uma única requisição mínima antes de mudar qualquer código da aplicação:

curl https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "broadnet/gemma-4-26b-a4b", "messages": [{"role": "user", "content": "ping"}], "max_tokens": 20}'

Troque a base URL, a chave e o modelo pelos do provedor que você está testando. Um 200 com um array choices significa que caminho, chave e ID do modelo estão certos. Um 404 normalmente indica caminho errado; um 401, chave ou região errada; um 400 muitas vezes cita o parâmetro que o provedor rejeita. O guia rápido de curl tem mais exemplos, e o gerador de requisições de API escreve as versões em curl, Python e Node para você.

Quais são os erros comuns ao trocar a base_url?

  • Colar o endpoint completo. O SDK acrescenta /chat/completions. Uma base URL que já termina assim gera /chat/completions/chat/completions e um 404.
  • Acrescentar ou tirar /v1 por hábito. A base documentada da DeepSeek não tem /v1, a da Z.ai termina em /v4/ e a do Gemini em /v1beta/openai/. Copie a string exata do provedor.
  • Manter os nomes de modelo da OpenAI. Nomes gpt-… falham em outros lugares. Cada provedor tem o próprio formato: deepseek-ai/DeepSeek-V4-Flash-0731 na DeepInfra, accounts/fireworks/models/… na Fireworks, broadnet/deepseek-v4.1-flash na BroadNet.
  • Enviar parâmetros que o provedor rejeita ou ignora. A Groq retorna 400 para logprobs; a camada da Anthropic ignora em silêncio seed, logit_bias e reasoning_effort. Um parâmetro ignorado em silêncio é pior que um erro, porque nada avisa você.
  • Supor os mesmos campos na resposta. A camada da Anthropic retorna prompt_tokens_details vazio, então a contagem de tokens em cache fica faltando. A Fireworks coloca o usage do streaming no último chunk, o que os tipos do SDK podem não declarar.
  • Supor que todo endpoint existe. “Compatível com a OpenAI” normalmente quer dizer chat completions. Embeddings, áudio, geração de imagens e a Responses API são outra história, como mostra a tabela.
  • Misturar regiões. As chaves da Alibaba são presas a uma região, e a Together oferece um host separado só para os EUA. Uma chave válida no host errado falha do mesmo jeito.

A lista completa para antes da troca está no checklist de migração para APIs compatíveis com a OpenAI.

Quais endpoints a BroadNet Inference aceita?

A referência da API da BroadNet documenta dois endpoints de modelo em https://inference.broadnet.ai/v1, além de GET /v1/models para os metadados do catálogo:

Endpoint Modelos
POST /v1/chat/completions DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B, BroadNet Gemma 4 VL 26B
POST /v1/audio/transcriptions BroadNet Transcribe Arabic, BroadNet Transcribe (14 idiomas)

Na prática:

  • Sem embeddings, geração de imagens ou Responses API na documentação. Uma ferramenta que exige um deles precisa de um segundo provedor para essa parte.
  • Chamada de ferramentas e saída estruturada estão documentadas para o GLM 5.3 e o Qwen3.8 27B.
  • Imagens entram como URLs data: dentro de partes de conteúdo image_url, no DeepSeek V4.1 Flash, no Qwen3.8 27B e no Gemma 4 VL 26B.
  • Modelos de raciocínio (DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B) contam o raciocínio em max_tokens. Deixe 1.000 tokens ou mais, ou defina reasoning_effort como low, como a documentação recomenda; veja por que modelos de raciocínio retornam respostas vazias.
  • Uma lista de modelos respondeu quando chamamos GET /v1/models em 15 de novembro de 2026, mas ela não está na lista de endpoints documentados, então não construa nada em cima dela.
  • Os limites das chaves de pagamento por uso são 30 requisições por minuto e 4 em andamento.

Preços por 1M de tokens: DeepSeek V4.1 Flash $0.175 de entrada e $0.52 de saída, Gemma 4 VL 26B $0.10 e $0.22. O DeepSeek V4.1 Flash também é vendido em plano de preço fixo a $60 por mês por sessão, uma requisição por vez.

Vale a pena rotear vários provedores por uma única base URL?

Se o seu app chama vários desses provedores, um proxy como o LiteLLM dá ao seu código uma única base URL e mapeia os nomes de modelo para cada upstream. Você escolhe o mapeamento; nada troca de provedor por você, a não ser que você mesmo configure fallbacks. Failover de API de LLM mostra como, no cliente ou no LiteLLM. O guia do proxy LiteLLM mostra uma entrada para a BroadNet. Para o significado do termo, veja API compatível com a OpenAI.

Onde a BroadNet Inference se encaixa

A BroadNet é uma boa opção se o seu código já fala chat completions e você quer modelos abertos, fala para texto em árabe e em vários idiomas, ou uma sessão DeepSeek de preço fixo em uma única chave. Não é a opção certa se você precisa de embeddings, da Responses API ou de geração de imagens no mesmo provedor; Together AI e Gemini documentam uma parte maior da superfície da OpenAI. Compare a nossa tabela com a documentação de cada provedor antes de ir para produção, porque essas URLs e listas de endpoints mudam.

Perguntas frequentes

Qual é a base URL da API da OpenAI?

https://api.openai.com/v1. O SDK Node oficial usa esse endereço quando você não define nem baseURL nem a variável de ambiente OPENAI_BASE_URL.

A base_url deve terminar em /v1 ou em /chat/completions?

Termine onde a documentação do provedor termina, normalmente em /v1. O SDK acrescenta /chat/completions sozinho, então uma base URL que já termina em /chat/completions gera um 404.

Dá para definir a base URL com uma variável de ambiente?

Sim. Os dois SDKs oficiais da OpenAI leem OPENAI_BASE_URL, e muitas ferramentas construídas sobre eles também. Defina OPENAI_API_KEY junto e confira a documentação de cada ferramenta, porque algumas usam nomes de variável próprios.

A API do Claude é compatível com a OpenAI?

Em parte. A Anthropic oferece https://api.anthropic.com/v1/ para o SDK da OpenAI, mas diz que essa camada serve principalmente para testar e comparar modelos, não como caminho de produção de longo prazo. Ela ignora strict nas ferramentas e rejeita entradas de áudio e de arquivo.

Quais endpoints a BroadNet Inference aceita?

A documentação lista POST /v1/chat/completions e POST /v1/audio/transcriptions. Não lista embeddings, geração de imagens nem a Responses API.

Por que minha requisição funciona na OpenAI mas falha em outro provedor?

Normalmente por um ID de modelo no formato errado ou por um parâmetro que o provedor rejeita. A Groq, por exemplo, retorna 400 para logprobs, logit_bias, top_logprobs e messages[].name. Remova os parâmetros opcionais e tente de novo com o ID de modelo exato do provedor.

Ler em MarkdownPerguntar ao ChatGPTPerguntar ao ClaudePerguntar ao Perplexity