---
title: "Migrer vers une API compatible OpenAI : checklist | BroadRouter"
description: "Changer base_url, c’est facile. Ce qui casse : ID de modèles, tokens de raisonnement, usage en streaming, erreurs, limites de débit et clés. Checklist avec code."
url: https://broadrouter.com/fr/blog/openai-compatible-api-migration-checklist/
lang: fr
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traduit de l’anglais avec l’aide de l’IA. [Lire l’original en anglais](https://broadrouter.com/blog/openai-compatible-api-migration-checklist/) (mis à jour le 2026-11-16).

# Passer à une API compatible OpenAI : la checklist de migration

Par l’équipe BroadNet Inference · 5 min de lecture · Publié 2026-11-14 · Mis à jour 2026-11-16

Pour passer à une API compatible OpenAI, modifiez trois paramètres (base\_url, api\_key et model), puis vérifiez ce qui diffère : les ID de modèles, la façon dont les tokens de raisonnement comptent dans max\_tokens, la façon dont le streaming remonte l’usage, les erreurs à réessayer, les limites de débit et la sécurité des clés. Pour BroadNet Inference, l’URL de base est https://inference.broadnet.ai/v1.

## À retenir

-   Trois paramètres changent : `base_url`, `api_key` et `model`.
-   Recensez chaque endpoint et chaque champ utilisés par votre application avant de basculer, puis testez-les un par un.
-   Les modèles de raisonnement comptent la réflexion dans `max_tokens` ; une limite basse renvoie des réponses vides.
-   Demandez l’usage dans les flux avec `stream_options`, sinon votre suivi des coûts devient aveugle.
-   Décidez, pour chaque code d’erreur, s’il faut réessayer ou corriger, avant de basculer le trafic de production.
-   Faites tourner l’ancien et le nouveau fournisseur en parallèle sur du trafic réel pendant une journée avant la bascule.

**Sur cette page**

1.  0\. Qu’utilise votre application aujourd’hui ?
2.  1\. Quels sont les trois paramètres qui changent ?
3.  2\. Quels sont les nouveaux ID de modèles ?
4.  3\. Pourquoi les réponses reviennent-elles vides après le changement ?
5.  4\. Le streaming remonte-t-il toujours l’usage ?
6.  5\. Quelles erreurs faut-il réessayer ?
7.  6\. Quelles sont les nouvelles limites de débit ?
8.  7\. Vos prompts tiennent-ils toujours ?
9.  8\. Et les clés et la conservation des données ?
10.  9\. Comment basculer en toute sécurité ?
11.  Quelles sont les erreurs de migration courantes ?
12.  La place de BroadNet Inference

La plupart des fournisseurs de LLM parlent désormais le [format de l’API OpenAI](https://broadrouter.com/fr/glossary/openai-compatible-api/). Changer de fournisseur ressemble donc à une modification d’une ligne, et pour obtenir une première réponse, c’est le cas. Pour faire passer du trafic de production, suivez cette liste. Chaque point correspond à une vraie façon dont les migrations échouent.

## 0\. Qu’utilise votre application aujourd’hui ?

Avant de modifier quoi que ce soit, notez ce dont dépend votre application. Cherchez dans le code chaque appel au SDK et listez-le. Si vous appelez l’API Whisper d’OpenAI, notez qu’OpenAI annonce l’arrêt de `whisper-1` le 26 février 2027 ; [les alternatives à l’API Whisper](https://broadrouter.com/fr/blog/whisper-api-alternative/) couvrent la partie audio.

| Fonctionnalité | Où chercher | Test après le changement |
| --- | --- | --- |
| Chat completions | Chaque `chat.completions.create` | Mêmes prompts, comparer les réponses |
| Streaming | `stream=True` | Les chunks arrivent, fin par `[DONE]`, usage présent |
| Appel d’outils | `tools=` | Les appels d’outils sont analysés et exécutés |
| Sortie structurée | `response_format=` | Le JSON est valide selon votre schéma |
| Images | Parties image dans les messages | Le modèle les accepte |
| Transcription audio | `audio.transcriptions` | Texte et langue corrects |
| Embeddings, fichiers, batchs | Autres endpoints | Vérifier que le fournisseur les propose |

La dernière ligne compte. « Compatible OpenAI » couvre généralement d’abord les chat completions. Le catalogue de BroadNet Inference liste des modèles de chat sur `/v1/chat/completions` et des modèles de speech-to-text sur `/v1/audio/transcriptions` ; si vous utilisez d’autres endpoints, gardez-les chez votre fournisseur actuel ou trouvez un remplaçant.

## 1\. Quels sont les trois paramètres qui changent ?

```python
from openai import OpenAI
import os

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)
```

Le nom du paramètre d’[URL de base](https://broadrouter.com/fr/glossary/base-url/) dépend de la bibliothèque : `base_url` dans le SDK Python et dans ChatOpenAI de LangChain, `baseURL` dans le SDK Node.js. Le SDK Python lit aussi la variable d’environnement `OPENAI_BASE_URL`, selon son [README](https://github.com/openai/openai-python). Vérifiez qu’aucune valeur périmée ne traîne dans votre environnement, sinon les requêtes peuvent partir vers l’ancien fournisseur sans erreur.

Gardez les [clés d’API](https://broadrouter.com/fr/glossary/api-key/) dans des variables d’environnement ou un gestionnaire de secrets, jamais dans le code. Configuration par SDK : [Python](https://broadrouter.com/fr/guides/openai-python-sdk/), [Node.js](https://broadrouter.com/fr/guides/openai-node-sdk/), [LangChain](https://broadrouter.com/fr/guides/langchain-openai-base-url/). Pour construire et tester une première requête à la main, utilisez le [générateur de requêtes API](https://broadrouter.com/tools/api-request-builder/). Pour appliquer les changements d’URL de base, de clé et de modèle à du code existant, collez-le dans l’[assistant de migration d’OpenAI vers BroadNet](https://broadrouter.com/tools/openai-to-broadnet-migration/), qui liste aussi ce qu’il faut vérifier.

## 2\. Quels sont les nouveaux ID de modèles ?

Chaque fournisseur nomme ses modèles à sa façon. Chez BroadNet Inference :

| Modèle | ID |
| --- | --- |
| DeepSeek V4.1 Flash | `broadnet/deepseek-v4.1-flash` |
| GLM 5.3 | `broadnet/glm-5.3` |
| Qwen3.8 27B | `broadnet/qwen3.8-27b` |
| Gemma 4 VL 26B | `broadnet/gemma-4-26b-a4b` |

Placez l’ID du modèle dans la configuration, pas dans le code : un futur changement sera un déploiement, pas une réécriture. Les limites et les prix de chaque modèle figurent sur sa page : [DeepSeek V4.1 Flash](https://broadrouter.com/fr/models/deepseek-v4.1-flash/), [GLM 5.3](https://broadrouter.com/fr/models/glm-5.3/), [Qwen3.8 27B](https://broadrouter.com/fr/models/qwen3.8-27b/) et [Gemma 4 VL 26B](https://broadrouter.com/fr/models/gemma-4-vl-26b/).

## 3\. Pourquoi les réponses reviennent-elles vides après le changement ?

C’est la surprise la plus fréquente. DeepSeek V4.1 Flash, GLM 5.3 et Qwen3.8 27B raisonnent avant de répondre, et **les [tokens de raisonnement](https://broadrouter.com/fr/glossary/reasoning-tokens/) comptent dans [`max_tokens`](https://broadrouter.com/fr/glossary/max-tokens/)**. Une limite de 256 qui fonctionnait sur un modèle sans raisonnement peut être entièrement consommée par la réflexion, et la réponse revient vide. Prévoyez 1 000 tokens ou plus, ou réglez `reasoning_effort` sur `low` pour les tâches simples. [Explication complète](https://broadrouter.com/fr/guides/reasoning-tokens-empty-response/).

## 4\. Le streaming remonte-t-il toujours l’usage ?

Les [flux](https://broadrouter.com/fr/glossary/streaming/) utilisent les Server-Sent Events et se terminent par `data: [DONE]`. L’usage des tokens n’arrive dans le dernier chunk que si vous le demandez :

```python
stream = client.chat.completions.create(
    model="broadnet/deepseek-v4.1-flash", messages=messages,
    stream=True, stream_options={"include_usage": True},
)
```

Sans cette option, votre tableau de bord des coûts affiche zéro. Si un flux se termine avant `[DONE]`, considérez-le comme incomplet. [Guide du streaming](https://broadrouter.com/fr/guides/streaming-chat-completions/).

## 5\. Quelles erreurs faut-il réessayer ?

| Statut | Signification | Action |
| --- | --- | --- |
| 401 | Clé invalide ou révoquée, ou allocation de paiement à l’usage épuisée | Corriger, ne pas réessayer |
| 402 | Solde ou budget | Recharger, ne pas réessayer |
| 403 | Refusé par la politique de modèle, de route ou d’IP | Corriger l’incohérence |
| 413 | Requête trop volumineuse | Réduire, ne pas réessayer |
| 429 | Limite de débit, de simultanéité ou de dépenses | Attendre (backoff) et réessayer |
| 5xx | Côté serveur | Réessayer avec un backoff borné |

Le SDK Python officiel réessaie déjà certaines erreurs : son README indique que les erreurs de connexion et les réponses 408, 409, 429 et 5xx sont réessayées deux fois par défaut avec un court backoff exponentiel. Définissez `max_retries` explicitement pour que ce comportement soit un choix et non une valeur par défaut. Journalisez l’ID de requête de chaque réponse pour que le support puisse retracer un problème. [Tous les codes](https://broadrouter.com/fr/guides/errors-and-retries/).

## 6\. Quelles sont les nouvelles limites de débit ?

Connaissez les nouvelles limites avant l’arrivée du trafic. Une clé BroadNet en paiement à l’usage autorise 30 requêtes par minute et 4 requêtes en cours. Les forfaits illimités traitent une requête à la fois par session. Dimensionnez votre pool de workers en conséquence, sinon vous verrez des 429 dès le premier jour ; le [calculateur de limites de débit](https://broadrouter.com/tools/llm-rate-limit-calculator/) fait le dimensionnement. [Dimensionner pour des agents en parallèle](https://broadrouter.com/fr/blog/run-parallel-coding-agents-flat-rate/).

## 7\. Vos prompts tiennent-ils toujours ?

Vérifiez les fenêtres de contexte : 1 048 576 tokens pour DeepSeek V4.1 Flash et GLM 5.3, 262 144 pour Qwen3.8 27B, 32 768 pour Gemma 4 VL 26B. Un prompt qui tenait dans votre ancien modèle peut ne pas tenir dans une fenêtre plus petite ; vérifiez-le avec le [calculateur de fenêtre de contexte](https://broadrouter.com/tools/context-window-calculator/). Placez le contenu stable du prompt en premier pour profiter du [tarif de l’entrée en cache](https://broadrouter.com/fr/blog/cached-input-tokens-explained/).

## 8\. Et les clés et la conservation des données ?

Limitez les clés de production aux IP de vos serveurs avec une [liste d’IP autorisées](https://broadrouter.com/fr/guides/api-keys-ip-allow-lists/). Demandez au nouveau fournisseur ce qu’il conserve ; voir la [checklist ZDR](https://broadrouter.com/fr/blog/zero-data-retention-llm-api-checklist/).

## 9\. Comment basculer en toute sécurité ?

1.  Envoyez une copie des requêtes réelles d’une journée aux deux fournisseurs.
2.  Comparez les réponses sur un échantillon, ainsi que la latence, les erreurs et le coût par requête.
3.  Basculez 10 % du trafic, observez pendant une journée, puis basculez le reste.
4.  Gardez l’ancien fournisseur configuré en solution de repli pendant une semaine.

Si vous exploitez de nombreux services, un proxy comme [LiteLLM](https://broadrouter.com/fr/guides/litellm-proxy-custom-provider/) vous permet de changer de fournisseur à un seul endroit plutôt que dans chaque application.

## Quelles sont les erreurs de migration courantes ?

-   **`/v1` absent de l’URL de base.** Les requêtes renvoient 404. Utilisez l’URL complète.
-   **Anciens noms de modèles dans la configuration.** Le nouveau fournisseur ne les connaît pas.
-   **Champs propres à l’ancien fournisseur laissés dans les requêtes.** Les champs que seul l’ancien fournisseur comprenait peuvent être rejetés ou ignorés. Retirez-les des clients génériques.
-   **Ne tester qu’un seul prompt.** Reprenez l’inventaire de l’étape 0, fonctionnalité par fonctionnalité.
-   **Basculer un vendredi.** Gardez du temps pour observer une journée complète de trafic réel.

## La place de BroadNet Inference

BroadNet Inference est un remplacement direct pour les applications qui utilisent les chat completions et la transcription audio via les SDK OpenAI : modifiez trois paramètres et suivez la liste ci-dessus. Son catalogue ne liste que des modèles de chat et de speech-to-text ; si vous dépendez d’autres endpoints, comme les embeddings ou le stockage de fichiers, gardez-les chez un autre fournisseur. Les nouveaux comptes démarrent avec $5 de crédit. Parmi les modèles de chat, seul Gemma 4 VL 26B en bénéficie (le crédit couvre aussi les deux modèles Transcribe) : un test en parallèle (shadow test) sur DeepSeek, GLM ou Qwen nécessite donc une recharge.

Outils gratuits sur ce sujet (en anglais)

-   [OpenAI to BroadNet migration helper](https://broadrouter.com/tools/openai-to-broadnet-migration/) Paste OpenAI SDK code; get base URL, key and model edits, a diff and the checks that remain.
-   [max\_tokens calculator for reasoning models](https://broadrouter.com/tools/reasoning-token-budget/) Answer length + reasoning budget + margin = a max\_tokens that does not cut the answer off.
-   [JSON schema generator for LLM structured output](https://broadrouter.com/tools/json-schema-generator/) Sample JSON to strict schema, Pydantic, Zod and a ready request.
-   [LLM JSON output validator](https://broadrouter.com/tools/llm-json-output-validator/) Parse errors by line and column, safe repairs, cut-off detection and JSON Schema checks for model output.

[Outils gratuits (en anglais)](https://broadrouter.com/tools/)

## Termes de cet article

[Streaming](https://broadrouter.com/fr/glossary/streaming/)

Le streaming est une manière de renvoyer la réponse d’un modèle de langage par petits chunks pendant sa génération, plutôt qu’en un seul bloc à la fin. Les API compatibles OpenAI streament via des server-sent events quand la requête règle stream sur true.

[Token](https://broadrouter.com/fr/glossary/token/)

Un token est l’unité de texte qu’un modèle de langage lit et écrit : un mot, une partie de mot, un signe de ponctuation ou une suite d’octets produite par le tokenizer du modèle. Les API LLM comptent, limitent et facturent généralement l’usage en tokens.

[Appel d’outils (tool calling, function calling)](https://broadrouter.com/fr/glossary/tool-calling/)

L’appel d’outils, aussi appelé function calling, est une fonctionnalité des API LLM dans laquelle le modèle renvoie une demande structurée d’exécution d’une fonction définie par le développeur, avec des arguments JSON. L’application exécute la fonction et renvoie le résultat ; le modèle n’exécute jamais de code lui-même.

[Embeddings (plongements vectoriels)](https://broadrouter.com/fr/glossary/embeddings/)

Les embeddings sont des listes de nombres à virgule flottante (des vecteurs) qu’un modèle produit pour représenter un texte, une image ou une autre entrée. Des entrées de sens proche obtiennent des vecteurs voisins : la distance entre vecteurs permet de classer des résultats de recherche, de regrouper des documents ou de trouver des éléments apparentés.

[Paiement à l’usage (pay-as-you-go)](https://broadrouter.com/fr/glossary/pay-as-you-go/)

Le paiement à l’usage (pay-as-you-go) est un modèle tarifaire où vous ne payez que ce que vous consommez, mesuré par unité, comme les tokens, les requêtes ou les minutes d’audio, sans abonnement ni engagement minimal. La plupart des API LLM facturent ainsi, à partir d’un solde prépayé ou d’une facture périodique.

[Speech-to-text (reconnaissance vocale)](https://broadrouter.com/fr/glossary/speech-to-text/)

Le speech-to-text, ou reconnaissance automatique de la parole (ASR), est une technologie qui convertit l’audio parlé en texte écrit. Une API speech-to-text accepte un fichier ou un flux audio et renvoie une transcription, généralement facturée à la minute d’audio. La précision se mesure avec le taux d’erreur de mots et varie selon l’accent, le dialecte et la qualité d’enregistrement.

[API Chat Completions](https://broadrouter.com/fr/glossary/chat-completions-api/)

L’API Chat Completions est l’endpoint HTTP d’OpenAI, POST /v1/chat/completions, qui reçoit un nom de modèle et une liste de messages associés à un rôle, et renvoie le message suivant du modèle. Sa forme de requête et de réponse est devenue le format commun que reprennent les fournisseurs et SDK compatibles OpenAI.

[Concurrence (requêtes simultanées)](https://broadrouter.com/fr/glossary/concurrency/)

La concurrence est le nombre de requêtes qu’un client a en cours au même moment. Les API de LLM la plafonnent souvent par clé ou par forfait, indépendamment des requêtes par minute, car chaque requête ouverte occupe de la capacité GPU jusqu’à la fin de sa réponse.

## Questions fréquentes

### Ai-je besoin d’un autre SDK ?

Non. Les SDK officiels d’OpenAI pour Python et Node.js acceptent une URL de base personnalisée. Les frameworks construits dessus, comme ChatOpenAI de LangChain, l’acceptent aussi.

### Comment changer l’URL de base dans le SDK OpenAI ?

Passez base\_url au client en Python ou baseURL en Node.js, ou définissez la variable d’environnement OPENAI\_BASE\_URL. Pour BroadNet Inference, la valeur est https://inference.broadnet.ai/v1, et la clé va dans api\_key.

### Pourquoi ai-je une réponse vide après le changement ?

Les modèles de raisonnement comme DeepSeek V4.1 Flash, GLM 5.3 et Qwen3.8 27B réfléchissent avant de répondre, et cette réflexion compte dans max\_tokens. Montez max\_tokens à 1 000 ou plus, ou réglez reasoning\_effort sur low.

### Pourquoi ai-je une erreur 404 ou « model not found » après le changement ?

En général, l’ID du modèle est encore celui de l’ancien fournisseur, ou il manque le chemin /v1 à l’URL de base. Utilisez l’ID exact du modèle chez le nouveau fournisseur et l’URL de base complète.

### Quelles erreurs dois-je réessayer ?

Réessayez les 429 et 5xx avec un backoff exponentiel borné. Corrigez les 401, 402 et 413 avant de réessayer. Le guide des erreurs de ce site liste chaque code.

### Compatible OpenAI veut-il dire identique ?

Non. La forme des requêtes et des réponses est la même, mais les ID de modèles, les paramètres pris en charge, les limites, les champs d’usage et le détail des erreurs peuvent différer. Testez chaque fonctionnalité utilisée par votre application.

## À lire ensuite

-   [URL de base des API compatibles OpenAI : 14 fournisseurs vérifiés](https://broadrouter.com/fr/blog/openai-compatible-api-base-urls/)
-   [OpenRouter ou forfait pour vos agents IA : lequel coûte moins cher ?](https://broadrouter.com/fr/blog/openrouter-alternative-flat-rate/)
-   [Quand une fenêtre de contexte de 1M de tokens vaut le coup (ou pas)](https://broadrouter.com/fr/blog/million-token-context-window-guide/)
-   [API LLM à conservation zéro des données : checklist en 10 questions](https://broadrouter.com/fr/blog/zero-data-retention-llm-api-checklist/)
-   [Matériel GPU et serving de BroadNet, tels que BroadNet les décrit](https://broadrouter.com/fr/blog/broadnet-gpu-fleet-and-serving/)
-   [Mettre en cache les réponses d’API LLM : un cache exact en Python](https://broadrouter.com/fr/blog/cache-llm-responses-cut-cost/)
-   [Guide : Utiliser le SDK Python d’OpenAI avec BroadNet Inference](https://broadrouter.com/fr/guides/openai-python-sdk/)
-   [Guide : Utiliser le SDK Node.js d’OpenAI avec BroadNet Inference](https://broadrouter.com/fr/guides/openai-node-sdk/)
-   [Guide : Utiliser LangChain avec BroadNet Inference](https://broadrouter.com/fr/guides/langchain-openai-base-url/)
-   [Guide : Codes d’erreur de BroadNet Inference : quand réessayer ?](https://broadrouter.com/fr/guides/errors-and-retries/)
-   [Guide : Streamer des chat completions et gérer les connexions coupées](https://broadrouter.com/fr/guides/streaming-chat-completions/)
-   [Guide : Pourquoi un modèle de raisonnement renvoie une réponse vide](https://broadrouter.com/fr/guides/reasoning-tokens-empty-response/)
-   [Guide : Router LiteLLM vers BroadNet Inference (SDK et proxy)](https://broadrouter.com/fr/guides/litellm-proxy-custom-provider/)

Essayez-le sur votre vraie charge de travail. Les nouveaux comptes démarrent avec USD 5 de crédit pour Gemma et transcription. DeepSeek, GLM et Qwen3.8 nécessitent une recharge.

[Commencer](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-blog-openai-compatible-api-migration-checklist&utm_content=page-cta) ·

**Sources**

-   [Référence de l’API de BroadNet Inference (en anglais)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-blog-openai-compatible-api-migration-checklist&utm_content=sources)
-   [README du SDK Python d’OpenAI (base\_url, OPENAI\_BASE\_URL, retries ; vérifié le 2026-11-14)](https://github.com/openai/openai-python)
