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.aisin/v1produce 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_URLantiguo 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.