BroadRouter
Começar

Base URL (URL base)

Atualizado em

A base URL é o endereço raiz fixo de uma API, como https://api.example.com/v1, que um cliente coloca antes de cada caminho de endpoint, como /chat/completions. Nos SDKs compatíveis com a OpenAI, trocar a base URL, junto com a chave de API e o ID do modelo, aponta o mesmo código para outro provedor.

Também chamado de: base URL, URL base, URL base da API, base_url, api_base, baseURL, OPENAI_BASE_URL, API base URL, endpoint URL

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.ai sem /v1 gera 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_URL antiga 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.

Perguntas frequentes

A base URL deve terminar em /v1?

Nos SDKs compatíveis com a OpenAI, sim, quando os caminhos do provedor começam com /v1. O SDK então acrescenta caminhos como /chat/completions. Confira o valor exato na documentação do provedor.

Dá para definir a base URL sem mexer no código?

Sim. Os SDKs oficiais da OpenAI para Python e Node leem a variável de ambiente OPENAI_BASE_URL quando você não passa uma base URL. Algumas ferramentas usam nomes de variável próprios, como OPENAI_API_BASE no Aider.

Qual é a base URL da BroadNet Inference?

https://inference.broadnet.ai/v1

Ler em MarkdownPerguntar ao ChatGPTPerguntar ao ClaudePerguntar ao Perplexity