# Qu'est-ce qui change lorsqu'on migre les requêtes OpenRouter vers une autre API compatible OpenAI ? > Changer l'URL de base et la clé API n'est que la première étape. Les champs de chat standard sont souvent portables, mais les ID de modèles, en-têtes et extensions OpenRouter, replis, détails de streaming, comptabilité, entrées multimodales, erreurs et limites doivent être testés derrière un adaptateur. # Qu'est-ce qui change lorsqu'on migre les requêtes OpenRouter vers une autre API compatible OpenAI ? Pour un chat simple, la migration peut commencer par une nouvelle URL de base, une clé et un ID de modèle. En production, routage, en-têtes, slugs, replis, métadonnées et sélection du fournisseur OpenRouter exigent des remplaçants, tandis que streaming et outils exigent des tests de contrat. La compatibilité OpenAI est un dialecte de transport, pas la promesse de catalogues, extensions, facturation ou exploitation identiques. ## Inventorier le contrat réellement utilisé Cherchez dans code, configuration et journaux chaque champ envoyé à OpenRouter. Sa configuration documentée utilise `https://openrouter.ai/api/v1`, l'authentification Bearer et des en-têtes d'attribution optionnels, avec parfois des extensions de routage. Créez cet inventaire : | Surface | Souvent portable | À vérifier | |---|---|---| | Chat | `messages`, temperature, limite de sortie | Paramètres et valeurs par défaut | | Modèles | Intention applicative | Slug spécifique | | Outils | Nom et JSON schema | Parallélisme, strict, arguments en flux | | Routage | Aucun | Préférences, replis, transforms | | En-têtes | Autorisation | Attribution et métadonnées OpenRouter | | Usage | Tokens | Coût, cache, consultation de requête | | Exploitation | Familles HTTP | Limites, tentatives, délais, erreurs | ## Introduire d'abord un adaptateur Ne dispersez pas URL et slugs dans le code. Encapsulez les différences et exposez des alias applicatifs. ```python from openai import OpenAI def make_client(base_url: str, api_key: str) -> OpenAI: return OpenAI(base_url=base_url, api_key=api_key) MODEL_MAP = { "coding_default": { "openrouter": "provider/model-slug", "target": "target-model-id", } } ``` L'adaptateur traduit aussi les champs, normalise les erreurs et émet des événements communs. ## Remplacer la sémantique des modèles et du routage Les ID de modèles ne sont pas standardisés. Mappez chaque alias vers le modèle cible et vérifiez contexte, outils, sortie structurée, modalités et prix dans le catalogue courant. La cible peut exprimer autrement le routage et les replis, ou ne pas les proposer. Décidez de les reconstruire dans votre orchestration, d'utiliser le routeur cible ou de les retirer. Un changement silencieux modifie coût et qualité. ## Retirer ou traduire les extensions OpenRouter Vérifiez en-têtes et champs spécifiques. Les en-têtes d'attribution optionnels peuvent généralement disparaître ; préférences, listes de repli, plugins, transforms et contrôles de métadonnées exigent un mapping explicite. Pendant les tests, refusez les extensions inconnues. Les ignorer silencieusement masque un changement de comportement. ## Tester outils et streaming par contrat Testez : * acceptation du nom et du JSON schema ; * modes tool choice et appels parallèles ; * événements incrémentaux d'arguments ; * raisons de fin et refus ; * arguments invalides et tentatives. Comparez des événements analysés, pas des chunks bruts. Incluez annulation, erreurs en cours de flux, usage final, deltas vides et reconnexion. ## Reconstruire la comptabilité OpenRouter documente des métadonnées avec modèle, fournisseur, tokens et coût total. La cible peut renvoyer l'usage dans la réponse, offrir une consultation séparée ou demander un calcul client. Normalisez dans votre registre : ```json { "request_id": "internal_123", "provider_request_id": "external_456", "gateway": "target", "model": "resolved-model-id", "input_tokens": 1200, "output_tokens": 340, "cost_usd": 0.0123 } ``` Séparez estimations et factures rapprochées. Revérifiez les limites budgétaires avant de migrer les agents de production. ## Vérifier les requêtes multimodales Image, audio et vidéo dépendent du modèle et de l'endpoint. Deux passerelles peuvent différer sur parties de contenu, upload, URL, tâches asynchrones et objets de sortie. Créez une fixture pour chaque modalité. Un chat texte réussi ne prouve pas la compatibilité média. ## Tester le comportement opérationnel Mesurez en-têtes de limite, codes rejouables, délais, file, région, idempotence, journaux et support. Utilisez la documentation actuelle de la cible. Un déploiement pratique a quatre étapes : 1. Rejouer un jeu de référence hors ligne. 2. Exécuter du trafic sûr en mode fantôme. 3. Faire un canary avec peu de trafic à faible risque. 4. Étendre seulement si erreurs, latence, coût et assertions restent sous les seuils. Gardez un retour simple jusqu'à avoir testé une charge représentative. ## Décider si la consolidation vaut la peine OpenRouter reste adapté si son catalogue LLM et son routage correspondent au produit. Atlas Cloud peut être intéressant si une relation compatible OpenAI pour texte, image et vidéo simplifie la pile. Aucun avantage ne remplace les tests. Décidez selon des besoins mesurés, pas le plus petit diff. ## Conclusion Changez la configuration, puis auditez chaque hypothèse non standard sur modèles, routage, outils, streaming, usage et exploitation. Un adaptateur et des tests de référence gardent la migration réversible et empêchent une requête valide de masquer une régression sémantique. ## FAQ ### Peut-on migrer en changeant seulement base_url et api_key ? Parfois pour un chat simple, mais une intégration de production dépend souvent des slugs, options de routage, en-têtes, flux, champs d'usage ou règles de repli qui doivent aussi changer. ### Quels champs OpenRouter sont les moins portables ? Préférences de fournisseur, listes de repli, en-têtes d'attribution, transforms, plugins et métadonnées spécifiques sont les cas fréquents. Isolez-les du modèle de requête central. ### Les API compatibles OpenAI utilisent-elles les mêmes noms de modèles ? Non. La compatibilité couvre généralement la forme de la requête, pas l'identité du catalogue. Mappez explicitement les alias applicatifs vers les ID courants de chaque passerelle. ### Comment tester le streaming après migration ? Enregistrez les événements de texte, arguments d'outils, raisons de fin, usage, annulation et erreurs. Comparez les événements analysés, pas les blocs d'octets bruts. ### Quel est le déploiement le plus sûr ? Utilisez un adaptateur, rejouez un jeu de référence, exécutez une petite part en mode fantôme, puis un canary à faible risque avec des seuils de retour pour erreurs, latence, coût et assertions. ### Quand faut-il rester sur OpenRouter ? Lorsque son large catalogue LLM, son routage et vos outils d'exploitation valent plus que la consolidation ailleurs. La migration doit répondre à des besoins mesurés, pas seulement à une promesse de compatibilité.