Toda requisição que um SDK faz é a base URL mais um caminho. Acerte a base URL e o resto do cliente funciona sem mudanças.
Como funciona
O cliente junta duas partes:
| Parte | Exemplo |
|---|---|
| Base URL | https://inference.broadnet.ai/v1 |
| Caminho do endpoint | /chat/completions |
| URL completa da requisição | https://inference.broadnet.ai/v1/chat/completions |
No código, o nome do parâmetro depende da biblioteca:
# Python SDK
client = OpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])
// Node SDK
const client = new OpenAI({ baseURL: "https://inference.broadnet.ai/v1", apiKey: process.env.BROADNET_API_KEY });
Os dois SDKs oficiais recorrem à variável de ambiente OPENAI_BASE_URL e, quando nada está definido, ao endereço da própria OpenAI. Outras ferramentas usam nomes como api_base ou OPENAI_API_BASE.
Por que importa
A base URL é o que faz de uma API compatível com a OpenAI uma troca direta. Ela também decide para onde vão os seus prompts e quem cobra você. Um valor errado pode mandar o tráfego, e a sua chave de API, para o provedor errado. Mantenha a base URL na configuração, ao lado da chave, e não fixa no código em vários lugares.
Os roteadores usam a mesma ideia: você aponta a base URL para o roteador em vez de para um provedor de modelos.
Na BroadNet Inference
A base URL é https://inference.broadnet.ai/v1 para todos os modelos: chat, visão e fala para texto. O chat vai para /chat/completions e a transcrição para /audio/transcriptions. O guia rápido com curl mostra uma primeira requisição, e o guia do LangChain mostra onde fica essa configuração em um framework.
Erros comuns
- Falta o
/v1.https://inference.broadnet.aisem/v1gera erros 404 no SDK. - Caminho duplicado. Colar o endpoint completo, como
.../v1/chat/completions, como base URL faz o SDK chamar.../chat/completions/chat/completions. - Variáveis de ambiente esquecidas. Uma
OPENAI_BASE_URLantiga no seu shell sobrescreve o que você espera. Imprima o valor quando as requisições forem para o lugar errado. - HTTP simples. Use sempre
https://. Chaves bearer precisam trafegar por TLS. - Trocar a URL, mas não o modelo. Cada provedor tem seus próprios IDs de modelo, como
broadnet/deepseek-v4.1-flash.
Vai migrar um app inteiro? Siga o checklist de migração.