Chaque requête d’un SDK, c’est l’URL de base plus un chemin. Avec la bonne URL de base, le reste du client fonctionne sans changement.
Comment ça marche
Le client assemble deux parties :
| Partie | Exemple |
|---|---|
| URL de base | https://inference.broadnet.ai/v1 |
| Chemin de l’endpoint | /chat/completions |
| URL complète de la requête | https://inference.broadnet.ai/v1/chat/completions |
Dans le code, le nom du paramètre dépend de la bibliothèque :
# 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 });
Les deux SDK officiels se rabattent sur la variable d’environnement OPENAI_BASE_URL, puis sur l’adresse d’OpenAI si rien n’est défini. D’autres outils utilisent des noms comme api_base ou OPENAI_API_BASE.
Pourquoi c’est important
C’est l’URL de base qui fait d’une API compatible OpenAI un simple changement de configuration. Elle décide aussi où partent vos prompts et qui vous facture. Une mauvaise valeur peut envoyer le trafic, et votre clé d’API, au mauvais fournisseur. Gardez-la dans la configuration à côté de la clé, plutôt que codée en dur à plusieurs endroits.
Les routeurs reposent sur la même idée : vous pointez l’URL de base vers le routeur au lieu d’un fournisseur de modèles.
Sur BroadNet Inference
L’URL de base est https://inference.broadnet.ai/v1 pour tous les modèles : chat, vision et speech-to-text. Le chat va sur /chat/completions et la transcription sur /audio/transcriptions. Le démarrage rapide avec curl montre une première requête, et le guide LangChain montre où se trouve le réglage dans un framework.
Erreurs fréquentes
/v1manquant.https://inference.broadnet.aisans/v1provoque des erreurs 404 dans le SDK.- Chemin en double. Coller l’endpoint complet, comme
.../v1/chat/completions, en guise d’URL de base fait appeler.../chat/completions/chat/completionsau SDK. - Variables d’environnement oubliées. Une ancienne
OPENAI_BASE_URLdans votre shell prend le pas sur ce que vous attendez. Affichez-la quand des requêtes partent au mauvais endroit. - HTTP en clair. Utilisez toujours
https://. Les clés Bearer doivent transiter via TLS. - Changer l’URL mais pas le modèle. Chaque fournisseur a ses propres ID de modèle, comme
broadnet/deepseek-v4.1-flash.
Vous migrez toute une application ? Suivez la checklist de migration.