---
title: "O que é a base URL de uma API de LLM? Com exemplos | BroadRouter"
description: "A base URL é o endereço raiz que um SDK coloca antes de cada caminho da API. Como ela funciona em clientes compatíveis com a OpenAI e os erros que causam 404."
url: https://broadrouter.com/pt/glossary/base-url/
lang: pt-BR
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traduzido do inglês com ajuda de IA. [Leia o original em inglês](https://broadrouter.com/glossary/base-url/) (atualizado em 2026-11-15).

# Base URL (URL base)

Atualizado em 2026-11-15

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
# Python SDK
client = OpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])
```

```js
// 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](https://broadrouter.com/pt/glossary/openai-compatible-api/) 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](https://broadrouter.com/pt/glossary/api-key/), 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](https://broadrouter.com/pt/glossary/llm-router/) 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](https://broadrouter.com/pt/guides/curl-quickstart/) mostra uma primeira requisição, e o [guia do LangChain](https://broadrouter.com/pt/guides/langchain-openai-base-url/) 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](https://broadrouter.com/pt/blog/openai-compatible-api-migration-checklist/).

## 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

## Veja também

-   [API compatível com a OpenAI](https://broadrouter.com/pt/glossary/openai-compatible-api/) (termo)
-   [Chave de API (API key)](https://broadrouter.com/pt/glossary/api-key/) (termo)
-   [LLM router (roteador de LLMs)](https://broadrouter.com/pt/glossary/llm-router/) (termo)
-   [Como usar o SDK Python da OpenAI com a BroadNet Inference](https://broadrouter.com/pt/guides/openai-python-sdk/) (guia)
-   [Como usar o SDK Node.js da OpenAI com a BroadNet Inference](https://broadrouter.com/pt/guides/openai-node-sdk/) (guia)
-   [Como usar o LangChain com a BroadNet Inference](https://broadrouter.com/pt/guides/langchain-openai-base-url/) (guia)
-   [Primeira requisição à BroadNet Inference com curl](https://broadrouter.com/pt/guides/curl-quickstart/) (guia)
-   [Migrar para uma API compatível com a OpenAI: checklist de migração](https://broadrouter.com/pt/blog/openai-compatible-api-migration-checklist/) (artigo)

Teste com a sua carga de trabalho real. Contas novas começam com US$ 5 de crédito para Gemma e transcrição. DeepSeek, GLM e Qwen3.8 exigem uma recarga.

[Começar](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-glossary-base-url&utm_content=page-cta) ·

**Fontes**

-   [README do SDK Python da OpenAI (base\_url e OPENAI\_BASE\_URL)](https://github.com/openai/openai-python)
-   [SDK Node da OpenAI (baseURL, com OPENAI\_BASE\_URL como padrão)](https://github.com/openai/openai-node)
-   [Guia rápido do OpenRouter (exemplo de base URL de terceiros)](https://openrouter.ai/docs/quickstart)
-   [Referência da API da BroadNet Inference (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-glossary-base-url&utm_content=sources)
