L'API OpenAI sert de base à de nombreuses applications d'IA. En connexion directe, les développeurs de certaines régions rencontrent néanmoins des problèmes de réseau, de paiement, de quotas et de conformité. Un relais de l'API OpenAI centralise l'accès et la facturation derrière une passerelle.
Cet article explique ce qu'est un relais, comment le choisir, comment migrer et quels risques sont associés.
Remarque : OpenAI et ChatGPT sont des marques de leurs détenteurs respectifs. Cet article n'a qu'une vocation d'explication technique ; les tarifs et interfaces applicables sont ceux de l'éditeur et du site.
1. Qu'est-ce qu'un relais de l'API OpenAI ?
Votre application → passerelle relais → OpenAI
Votre code utilise toujours le SDK OpenAI ; seuls l'URL de base, la clé et le nom du modèle changent. La passerelle gère l'authentification, la facturation, les journaux et le routage.
2. Ce qu'il permet de résoudre
- Une connexion instable depuis certaines régions.
- Des moyens de paiement peu pratiques.
- Un besoin de facturation et de quotas unifiés pour l'équipe.
- L'accès simultané à Claude, Gemini et DeepSeek.
- Un besoin de journaux d'usage et d'un diagnostic des erreurs.
3. Critères de choix
| Critère | À vérifier |
|---|---|
| Couverture des modèles | Gamme GPT complète, versions à jour |
| Compatibilité | Chat Completions et Responses, streaming, appels d'outils |
| Stabilité | Taux d'erreur, P95, limitation de débit, nouvelles tentatives |
| Facturation | Calcul de l'entrée, de la sortie et du cache |
| Quotas | Plafonds par clé, membre ou projet |
| Journaux | Tokens, durée et erreur pour chaque appel |
| Conformité | Conservation des données, contrat, factures |
4. Étapes de migration
4.1 Modifier l'URL de base
https://ai.zhongshangqihang.com/v1
4.2 Changer la clé
Créez une clé sur ZSQH AI Gateway et fixez un quota.
4.3 Modifier le nom du modèle
Copiez le nom du modèle actuellement pris en charge depuis la page Tarifs des modèles. D'anciens noms peuvent avoir été retirés.
4.4 Déployer progressivement
Basculez d'abord 5 à 10 % du trafic, observez pendant 3 à 7 jours, puis augmentez la part.
5. Exemple Python
from openai import OpenAI
client = OpenAI(
api_key="sk-votre-clé",
base_url="https://ai.zhongshangqihang.com/v1",
)
resp = client.chat.completions.create(
model="gpt-5",
messages=[{"role": "user", "content": "Réponds seulement OK"}],
)
print(resp.choices[0].message.content)
6. Liste de tests
- Requêtes ordinaires et en streaming.
- Appel d'outils et sortie structurée.
- Contexte long.
- Concurrence de 5, 10 et 20 requêtes.
- Codes d'erreur 401, 404, 429 et 5xx.
- Vérification de la facture.
7. Risques et pièges
- Un « relais à bas prix » limité à quelques modèles peut devenir indisponible sans préavis.
- Un nom de modèle obsolète ou un paramètre non pris en charge peut provoquer une panne en production.
- Une fuite de clé épuise rapidement le solde : fixez impérativement un plafond.
- Avant tout usage en entreprise, vérifiez les clauses de données, la facturation et la conformité.
- Ne concentrez pas tout le trafic sur un seul canal : conservez une solution de secours.
8. Connexion directe ou relais ?
| Critère | Connexion directe | Passerelle relais |
|---|---|---|
| Accès | Dépend du réseau | Accessible depuis votre région |
| Paiement | Moyens de l'éditeur | Recharge sur le site |
| Modèles | OpenAI uniquement | Plusieurs modèles possibles |
| Facturation | Console de l'éditeur | Console unifiée |
| Risques | Seuils liés au compte et au paiement | Risque lié au choix du fournisseur |
Questions fréquentes
Faut-il modifier le code pour passer par un relais ?
Avec le SDK OpenAI, il suffit en général de changer l'URL de base, la clé et le nom du modèle.
Le relais modifie-t-il les résultats du modèle ?
En général, le modèle amont reste le même, mais la version du canal, les paramètres et la limitation de débit peuvent différer. Avant une migration, comparez avec un jeu de tests fixe.
Peut-on l'auto-héberger ?
Oui. Des passerelles open source comme New API ou One API peuvent être déployées soi-même, mais il faut un serveur, des canaux amont et de l'exploitation. Voir notre guide auto-héberger une passerelle ou choisir un service managé.
Pour aller plus loin
Pour un accès stable ou un point d'entrée unique vers plusieurs modèles, vous pouvez créer un compte sur ZSQH AI Gateway et tester avec une clé à faible quota. Les modèles et tarifs applicables sont ceux de la page Tarifs des modèles.
Lectures associées :
