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/completionse um 404. - Acrescentar ou tirar
/v1por 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-0731na DeepInfra,accounts/fireworks/models/…na Fireworks,broadnet/deepseek-v4.1-flashna BroadNet. - Enviar parâmetros que o provedor rejeita ou ignora. A Groq retorna 400 para
logprobs; a camada da Anthropic ignora em silêncioseed,logit_biasereasoning_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_detailsvazio, 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údoimage_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 definareasoning_effortcomolow, como a documentação recomenda; veja por que modelos de raciocínio retornam respostas vazias. - Uma lista de modelos respondeu quando chamamos
GET /v1/modelsem 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.
