BroadRouter
Commencer

URL de base (base URL)

Mis à jour

L’URL de base est l’adresse racine fixe d’une API, comme https://api.example.com/v1, que le client place devant chaque chemin d’endpoint, comme /chat/completions. Dans les SDK compatibles OpenAI, changer l’URL de base, avec la clé d’API et l’ID du modèle, oriente le même code vers un autre fournisseur.

Aussi appelé : URL de base, URL racine de l’API, URL d’endpoint, base URL, API base URL, api_base, baseURL, OPENAI_BASE_URL, endpoint URL

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

  • /v1 manquant. https://inference.broadnet.ai sans /v1 provoque 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/completions au SDK.
  • Variables d’environnement oubliées. Une ancienne OPENAI_BASE_URL dans 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.

Questions fréquentes

L’URL de base doit-elle se terminer par /v1 ?

Pour les SDK compatibles OpenAI, oui, quand les chemins du fournisseur commencent par /v1. Le SDK ajoute ensuite des chemins comme /chat/completions. Vérifiez la valeur exacte dans la documentation du fournisseur.

Puis-je définir l’URL de base sans modifier le code ?

Oui. Les SDK officiels d’OpenAI pour Python et Node lisent la variable d’environnement OPENAI_BASE_URL si vous ne passez pas d’URL de base. Certains outils utilisent leurs propres noms de variables, comme OPENAI_API_BASE dans Aider.

Quelle est l’URL de base de BroadNet Inference ?

https://inference.broadnet.ai/v1

Lire en MarkdownDemander à ChatGPTDemander à ClaudeDemander à Perplexity