Qu'est-ce qu'une API compatible OpenAI ? Comment changer de fournisseur en une ligne

Changez en une ligne

Les SDK OpenAI envoient les requêtes à OpenAI par défaut, mais acceptent une URL de base. Faites-la pointer vers un autre fournisseur et utilisez sa clé et ses noms de modèles ; le reste du code ne change pas.

from openai import OpenAI
client = OpenAI(
    base_url="https://api.zurelay.com/v1",  # the only line that changes
    api_key="YOUR_ZURELAY_KEY",
)
reply = client.chat.completions.create(
    model="claude-sonnet-5-5",
    messages=[{"role": "user", "content": "Hello"}],
)
print(reply.choices[0].message.content)

Cela fonctionne aussi en TypeScript avec baseURL, et dans les outils qui demandent une "OpenAI base URL" ou un "custom endpoint" : OpenCode, Continue, Cline, Open WebUI et bien d'autres. Les guides d'intégration détaillent les réglages de chacun. De nombreux outils lisent aussi les variables d'environnement OPENAI_BASE_URL et OPENAI_API_KEY : vous pouvez donc changer de fournisseur sans toucher au code.

URL de base des principaux fournisseurs

L’URL de base se termine généralement par /v1, et le SDK y ajoute /chat/completions. Certains fournisseurs utilisent d’autres chemins : copiez-les donc à l’identique :

L’URL de chaque fournisseur, avec un identifiant de modèle et les fonctions de chaque endpoint, figure dans la liste des URL de base compatibles avec OpenAI, établie à partir de la documentation de chaque fournisseur le 26 octobre 2026.

Ce qui reste compatible

• Les messages, les prompts système et le streaming.
• Les appels d’outils et les sorties structurées avec un schéma JSON.
• Les images et autres fichiers dans les messages, pour les modèles capables de les lire.
• Le bloc d’utilisation, pour conserver le même décompte des tokens.

Les points à vérifier avant de changer

• Les noms des modèles. Chaque fournisseur a ses propres identifiants ; affichez-les avec GET /v1/models.
• Les API disponibles. Beaucoup de fournisseurs proposent Chat Completions, mais pas les API Responses, Realtime, embeddings ou batch d’OpenAI. Zurelay propose Chat Completions, la génération d’images, de vidéos et de voix, ainsi que l’API Messages d’Anthropic pour Claude.
• Les paramètres supplémentaires. Les niveaux de raisonnement, les contrôles du cache et les limites d’échantillonnage varient selon le modèle. Un bon fournisseur indique les paramètres acceptés par chaque modèle.
• Est-ce bien le modèle annoncé ? Les fournisseurs à bas prix proposent parfois un modèle plus ancien ou moins cher sous un nom plus récent. Retrouvez cinq vérifications rapides dans ce que vendent vraiment les API d’IA à bas prix.

Si le changement ne fonctionne pas

• 404 Not Found. L’URL de base inclut l’endpoint (.../v1/chat/completions) ou ne contient pas le chemin propre au fournisseur. Utilisez uniquement l’URL de base.
• 401 Unauthorized. La clé appartient à un autre fournisseur ou, sur Model Studio d’Alibaba, à une autre région.
• Model not found. Pour un même modèle, les identifiants varient selon le fournisseur : claude-opus-5-5 chez Anthropic, anthropic/claude-opus-5 sur OpenRouter, le nom de votre déploiement sur Azure.
• Erreur 400 sur un paramètre. Certains fournisseurs rejettent ou ignorent des paramètres acceptés par l’API d’OpenAI, comme response_format dans la couche de compatibilité d’Anthropic. Supprimez-le ou choisissez un fournisseur qui le prend en charge.

API compatibles avec Anthropic

Claude Code et les SDK d’Anthropic utilisent plutôt l’API Messages d’Anthropic et lisent ANTHROPIC_BASE_URL. Plusieurs fournisseurs proposent aussi cette API, dont DeepSeek, Moonshot, Z.ai, MiniMax et Zurelay ; leurs URL ne se terminent jamais par /v1. Vous les trouverez dans la liste, et la page Tarifs de Claude Code compare le coût de Claude Code avec chaque abonnement et via l’API.

Pourquoi changer de fournisseur

Une seule clé compatible avec OpenAI donne accès aux modèles de plusieurs labos : pour comparer Claude, GPT, Gemini et DeepSeek avec vos propres prompts, il suffit de changer le nom du modèle. Même chose pour passer à un modèle moins cher. Consultez les modèles et tarifs.