BroadRouter
Comenzar

URL base (base URL)

Actualizado

La URL base es la dirección raíz fija de una API, como https://api.example.com/v1, que un cliente antepone a cada ruta de endpoint, como /chat/completions. En los SDKs compatibles con OpenAI, cambiar la URL base, junto con la clave de API y el ID del modelo, dirige el mismo código a otro proveedor.

También llamado: URL base, URL base de la API, base_url, URL del endpoint, base URL, API base URL, api_base, baseURL, OPENAI_BASE_URL, endpoint URL

Cada solicitud que hace un SDK es la URL base más una ruta. Si la URL base es correcta, el resto del cliente funciona sin cambios.

Cómo funciona

El cliente une dos partes:

Parte Ejemplo
URL base https://inference.broadnet.ai/v1
Ruta del endpoint /chat/completions
URL completa de la solicitud https://inference.broadnet.ai/v1/chat/completions

En el código, el nombre del parámetro depende de la 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 });

Ambos SDKs oficiales recurren a la variable de entorno OPENAI_BASE_URL y, si no hay nada configurado, a la dirección de la propia OpenAI. Otras herramientas usan nombres como api_base u OPENAI_API_BASE.

Por qué importa

La URL base es lo que convierte a una API compatible con OpenAI en un cambio directo. También decide adónde van sus prompts y quién le factura. Un valor incorrecto puede enviar el tráfico, y su clave de API, al proveedor equivocado. Guárdela en la configuración junto a la clave, no escrita a mano en varios lugares.

Los routers usan la misma idea: usted apunta la URL base al router en lugar de a un proveedor de modelos.

En BroadNet Inference

La URL base es https://inference.broadnet.ai/v1 para todos los modelos: chat, visión y voz a texto. El chat va a /chat/completions y la transcripción a /audio/transcriptions. La guía rápida con curl muestra una primera solicitud, y la guía de LangChain muestra dónde va este ajuste en un framework.

Errores comunes

  • Falta /v1. https://inference.broadnet.ai sin /v1 produce errores 404 en el SDK.
  • Ruta duplicada. Pegar el endpoint completo, como .../v1/chat/completions, como URL base hace que el SDK llame a .../chat/completions/chat/completions.
  • Variables de entorno olvidadas. Un OPENAI_BASE_URL antiguo en su shell reemplaza lo que usted espera. Imprímalo cuando las solicitudes vayan al lugar equivocado.
  • HTTP sin cifrar. Use siempre https://. Las claves bearer deben viajar por TLS.
  • Cambiar la URL pero no el modelo. Cada proveedor tiene sus propios IDs de modelo, como broadnet/deepseek-v4.1-flash.

¿Va a migrar una app completa? Siga la lista de verificación para migrar.

Preguntas frecuentes

¿La URL base debe terminar en /v1?

En los SDKs compatibles con OpenAI, sí, cuando las rutas del proveedor empiezan con /v1. El SDK luego agrega rutas como /chat/completions. Revise la documentación del proveedor para el valor exacto.

¿Puedo configurar la URL base sin cambiar el código?

Sí. Los SDKs oficiales de OpenAI para Python y Node leen la variable de entorno OPENAI_BASE_URL cuando usted no pasa una URL base. Algunas herramientas usan sus propios nombres de variable, como OPENAI_API_BASE en Aider.

¿Cuál es la URL base de BroadNet Inference?

https://inference.broadnet.ai/v1

Leer en MarkdownPreguntar a ChatGPTPreguntar a ClaudePreguntar a Perplexity