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/completionset une 404. - Ajouter ou retirer
/v1par 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-0731chez DeepInfra,accounts/fireworks/models/…chez Fireworks,broadnet/deepseek-v4.1-flashchez BroadNet. - Envoyer des paramètres que le fournisseur refuse ou ignore. Groq renvoie 400 pour
logprobs; la couche d’Anthropic ignore silencieusementseed,logit_biasetreasoning_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_detailsvide : 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 contenuimage_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églezreasoning_effortsurlow, 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/modelsle 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.
