BroadRouter
Commencer

URL de base des API compatibles OpenAI : 14 fournisseurs vérifiés

Par l’équipe BroadNet Inference · 6 min de lecture · Publié

Une API compatible OpenAI vous permet de garder le SDK OpenAI en changeant deux choses : base_url et la clé d’API. L’URL de base varie selon le fournisseur, par exemple https://api.groq.com/openai/v1 pour Groq, https://openrouter.ai/api/v1 pour OpenRouter et https://inference.broadnet.ai/v1 pour BroadNet Inference. Les chemins, les ID de modèle et les paramètres acceptés diffèrent malgré tout : testez une requête avant de basculer.

Une API compatible OpenAI accepte le même format de requête que l’API d’OpenAI : les SDK officiels d’OpenAI fonctionnent donc dès que vous changez base_url et la clé d’API. La difficulté, c’est que chaque fournisseur place son endpoint à un endroit légèrement différent. Le tableau ci-dessous en liste 14, chacun relevé dans la documentation du fournisseur lui-même le 15 novembre 2026.

Quelle est l’URL de base de chaque fournisseur compatible OpenAI ?

Fournisseur URL de base Ce que liste sa doc de compatibilité OpenAI Particularités indiquées dans la doc
OpenAI https://api.openai.com/v1 Tout ; c’est la référence Valeur par défaut du SDK si rien n’est défini
Anthropic https://api.anthropic.com/v1/ Chat completions « Primarily intended to test and compare model capabilities » (traduction : « principalement destinée à tester et comparer les capacités des modèles ») ; strict ignoré ; les entrées audio et fichier renvoient 400
Google Gemini https://generativelanguage.googleapis.com/v1beta/openai/ Chat completions, embeddings, génération d’images, modèles, batch Prise en charge de la bibliothèque OpenAI « still in beta » (traduction : « encore en bêta ») ; pas de Responses API listée
DeepSeek https://api.deepseek.com Chat completions Pas de chemin de version ; URL distincte au format Anthropic sur /anthropic
Groq https://api.groq.com/openai/v1 Chat completions, Responses API ; notes sur la transcription audio logprobs, logit_bias, top_logprobs, messages[].name renvoient 400 ; n doit valoir 1 ; pas de transcription en srt ni vtt
Together AI https://api.together.ai/v1 Chat, completions, images, synthèse vocale, transcriptions, modèles, Responses Inférence aux États-Unis uniquement sur https://us-api.together.ai/v1 ; embeddings seulement sur endpoints dédiés
Fireworks AI https://api.fireworks.ai/inference/v1 Chat completions ID de modèle du type accounts/fireworks/models/… ; réduit max_tokens pour tenir dans le contexte au lieu de renvoyer une erreur, sauf indication contraire
DeepInfra https://api.deepinfra.com/v1/openai Chat completions ; les clients Responses utilisent la même base Embeddings, images et synthèse vocale documentés sur une page séparée
Mistral AI https://api.mistral.ai/v1 POST /v1/chat/completions Sa référence d’API ne se dit pas compatible OpenAI ; testez avant de vous y fier
OpenRouter https://openrouter.ai/api/v1 Chat completions En-têtes facultatifs HTTP-Referer et X-OpenRouter-Title pour ses classements
xAI https://api.x.ai/v1 Responses API Son guide indique « The Responses API is the preferred way of interacting with our models » (traduction : « La Responses API est la manière privilégiée d’interagir avec nos modèles »)
Z.ai (GLM) https://api.z.ai/api/paas/v4/ Chat completions Chemin v4, pas v1
Alibaba Model Studio https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 (Singapour) Chat completions ID d’espace de travail dans le nom d’hôte ; une clé ne fonctionne que dans la région où elle a été créée, sinon 401
BroadNet Inference https://inference.broadnet.ai/v1 Chat completions, transcriptions audio Les ID de modèle commencent par broadnet/ ; voir plus bas

Alibaba liste aussi un endpoint aux États-Unis (Virginie) sur us-east-1. Sa ligne pour Pékin, sur la même page, affiche l’hôte de Singapour alors qu’un autre passage de la page cite cn-beijing : confirmez un endpoint en Chine dans la console. Ce tableau est un instantané. Les endpoints bougent : les docs d’Anthropic et de Google ont toutes deux été redirigées vers de nouvelles adresses pendant nos vérifications.

Pour les prix de ces fournisseurs, voir les pages prix des API LLM par fournisseur.

Comment définir l’URL de base dans le code ?

En Python, passez base_url au client :

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)
r = client.chat.completions.create(
    model="broadnet/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": "Say hello in one line."}],
)
print(r.choices[0].message.content)

En Node, l’option s’appelle baseURL :

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://inference.broadnet.ai/v1",
  apiKey: process.env.BROADNET_API_KEY,
});

Vous pouvez aussi la définir une fois pour tous les outils qui utilisent les SDK officiels. Dans le code source du SDK Node, baseURL vaut par défaut process.env['OPENAI_BASE_URL'], puis https://api.openai.com/v1 ; le README Python documente la même variable :

export OPENAI_BASE_URL="https://inference.broadnet.ai/v1"
export OPENAI_API_KEY="your-key"

Pas-à-pas complets : SDK OpenAI pour Python, SDK OpenAI pour Node. Pour savoir ce qu’est une URL de base et pourquoi les outils la demandent, voir le glossaire.

Comment tester une nouvelle URL de base avec curl ?

Envoyez une toute petite requête avant de modifier le moindre code applicatif :

curl https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "broadnet/gemma-4-26b-a4b", "messages": [{"role": "user", "content": "ping"}], "max_tokens": 20}'

Remplacez l’URL de base, la clé et le modèle par ceux du fournisseur que vous testez. Un 200 avec un tableau choices signifie que le chemin, la clé et l’ID de modèle sont bons. Un 404 signifie en général que le chemin est faux ; un 401, que la clé ou la région est fausse ; un 400 nomme souvent le paramètre refusé par le fournisseur. Le démarrage rapide curl donne d’autres exemples, et le générateur de requêtes API écrit pour vous les versions curl, Python et Node.

Quelles sont les erreurs courantes en changeant base_url ?

  • Coller l’endpoint complet. Le SDK ajoute /chat/completions. Une URL de base qui se termine déjà ainsi donne /chat/completions/chat/completions et une 404.
  • Ajouter ou retirer /v1 par habitude. La base documentée de DeepSeek n’a pas de /v1, celle de Z.ai se termine par /v4/ et celle de Gemini par /v1beta/openai/. Copiez la chaîne exacte du fournisseur.
  • Garder les noms de modèles OpenAI. Les noms gpt-… échouent ailleurs. Chaque fournisseur a son propre format : deepseek-ai/DeepSeek-V4-Flash-0731 chez DeepInfra, accounts/fireworks/models/… chez Fireworks, broadnet/deepseek-v4.1-flash chez BroadNet.
  • Envoyer des paramètres que le fournisseur refuse ou ignore. Groq renvoie 400 pour logprobs ; la couche d’Anthropic ignore silencieusement seed, logit_bias et reasoning_effort. Un paramètre ignoré en silence est pire qu’une erreur, car rien ne vous prévient.
  • Supposer les mêmes champs de réponse. La couche d’Anthropic renvoie un prompt_tokens_details vide : le décompte des tokens en cache manque. Fireworks place l’usage du streaming dans le dernier chunk, ce que les types du SDK ne déclarent pas forcément.
  • Supposer que chaque endpoint existe. « Compatible OpenAI » veut généralement dire chat completions. Embeddings, audio, génération d’images et Responses API sont des questions distinctes, comme le montre le tableau.
  • Mélanger les régions. Les clés Alibaba sont liées à une région, et Together propose un hôte séparé réservé aux États-Unis. Une clé valide sur le mauvais hôte échoue quand même.

La liste complète avant migration se trouve dans la checklist de migration vers une API compatible OpenAI.

Quels endpoints BroadNet Inference prend-il en charge ?

La référence de l’API de BroadNet documente deux endpoints de modèles sur https://inference.broadnet.ai/v1, plus GET /v1/models pour les métadonnées du catalogue :

Endpoint Modèles
POST /v1/chat/completions DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B, BroadNet Gemma 4 VL 26B
POST /v1/audio/transcriptions BroadNet Transcribe Arabic, BroadNet Transcribe (14 langues)

Ce que cela signifie en pratique :

  • Ni embeddings, ni génération d’images, ni Responses API ne sont documentés. Un outil qui en a besoin nécessite un second fournisseur pour cette partie.
  • L’appel d’outils et la sortie structurée sont documentés pour GLM 5.3 et Qwen3.8 27B.
  • Les images s’envoient en URL data: dans des parties de contenu image_url, sur DeepSeek V4.1 Flash, Qwen3.8 27B et Gemma 4 VL 26B.
  • Les modèles de raisonnement (DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B) comptent le raisonnement dans max_tokens. Laissez 1 000 tokens ou plus, ou réglez reasoning_effort sur low, comme le conseille la doc ; voir pourquoi les modèles de raisonnement renvoient des réponses vides.
  • Une liste de modèles a répondu quand nous avons appelé GET /v1/models le 15 novembre 2026, mais elle ne figure pas dans la liste des endpoints documentés : ne bâtissez rien dessus.
  • Les limites des clés à l’usage sont de 30 requêtes par minute et 4 requêtes simultanées.

Prix par million de tokens : DeepSeek V4.1 Flash $0.175 en entrée et $0.52 en sortie, Gemma 4 VL 26B $0.10 et $0.22. DeepSeek V4.1 Flash est aussi vendu en forfait à $60 par mois et par session, une requête à la fois.

Faut-il faire passer plusieurs fournisseurs par une seule URL de base ?

Si votre application appelle plusieurs de ces fournisseurs, un proxy comme LiteLLM donne à votre code une seule URL de base et associe les noms de modèles à chaque fournisseur en amont. C’est vous qui choisissez cette correspondance ; rien ne change de fournisseur à votre place tant que vous ne configurez pas vous-même de bascules. Le failover des API LLM montre comment faire, dans un client ou dans LiteLLM. Le guide du proxy LiteLLM montre une entrée BroadNet. Pour le contexte du terme, voir API compatible OpenAI.

La place de BroadNet Inference

BroadNet convient si votre code parle déjà chat completions et que vous voulez des modèles ouverts, du speech-to-text en arabe et en plusieurs langues, ou une session DeepSeek au forfait, avec une seule clé. Il ne convient pas si vous avez besoin d’embeddings, de la Responses API ou de génération d’images chez le même fournisseur ; Together AI et Gemini documentent une plus grande partie de l’interface OpenAI. Comparez notre tableau avec la doc de chaque fournisseur avant la mise en production, car ces URL et ces listes d’endpoints changent.

Questions fréquentes

Quelle est l’URL de base de l’API OpenAI ?

https://api.openai.com/v1. Le SDK officiel pour Node l’utilise si vous ne définissez ni baseURL ni la variable d’environnement OPENAI_BASE_URL.

base_url doit-elle se terminer par /v1 ou par /chat/completions ?

Arrêtez-la là où la doc du fournisseur l’arrête, en général à /v1. Le SDK ajoute /chat/completions lui-même : une URL de base qui se termine déjà par /chat/completions produit une erreur 404.

Puis-je définir l’URL de base avec une variable d’environnement ?

Oui. Les deux SDK officiels d’OpenAI lisent OPENAI_BASE_URL, et beaucoup d’outils construits dessus aussi. Définissez OPENAI_API_KEY en même temps, et vérifiez la doc de chaque outil, car certains utilisent leurs propres noms de variables.

L’API Claude est-elle compatible OpenAI ?

En partie. Anthropic propose https://api.anthropic.com/v1/ pour le SDK OpenAI, mais précise que cette couche sert surtout à tester et comparer des modèles, pas de voie de production à long terme. Elle ignore strict sur les outils et refuse les entrées audio et fichier.

Quels endpoints BroadNet Inference prend-il en charge ?

Sa doc liste POST /v1/chat/completions et POST /v1/audio/transcriptions. Elle ne mentionne ni embeddings, ni génération d’images, ni Responses API.

Pourquoi ma requête fonctionne-t-elle chez OpenAI mais échoue chez un autre fournisseur ?

En général, un ID de modèle au mauvais format ou un paramètre que le fournisseur refuse. Groq, par exemple, renvoie 400 pour logprobs, logit_bias, top_logprobs et messages[].name. Retirez les paramètres optionnels et réessayez avec l’ID de modèle exact du fournisseur.

Lire en MarkdownDemander à ChatGPTDemander à ClaudeDemander à Perplexity