https://api.phaseo.app/v1 et la clé par PHASEO_API_KEY. Les charges utiles des requêtes, l’en-tête Authorization: Bearer, l’objet provider et le tableau de secours models continuent de fonctionner ; vérifiez les identifiants de modèle et les quelques champs du tableau ci-dessous.
Changer de client
OPENROUTER_BASE_URL et l’ancienne clé du code, de la CI et des paramètres d’hébergement. @openrouter/ai-sdk-provider devient @phaseo/ai-sdk-provider (voir Migrer depuis Vercel AI Gateway) ; les SDK propres à OpenRouter (@openrouter/sdk, openrouter sur PyPI) nécessitent un changement de client, pas seulement une nouvelle URL de base.
Vérifier les identifiants de modèle
La plupart des identifiants correspondent, mais certaines organisations diffèrent :x-ai/ devient spacex-ai/, meta-llama/ devient meta/ et mistralai/ devient mistral/. Listez les identifiants Phaseo et vérifiez chaque modèle de production par rapport à cette liste :
availability=all pour voir les modèles inactifs ou à venir. Sans format=openai, la réponse est la liste paginée models de Phaseo, qui ne contient pas de tableau data.
Faire correspondre les champs de requête
Phaseo propose aussi
provider.required_execution_region et provider.required_data_region, qui n’ont pas d’équivalent OpenRouter. Consultez Épingler ou ignorer des fournisseurs et Router uniquement vers des fournisseurs UE ou compatibles ZDR pour des requêtes complètes.
Regroupez les champs propres à OpenRouter qui restent dans un seul adaptateur plutôt qu’à chaque point d’appel, pour que le retour arrière reste un changement d’URL de base et de clé.
Valider avant la bascule
Exécutez ces commandes sur Phaseo, puis les mêmes vérifications via le chemin client de votre application :OPENROUTER_API_KEYest remplacée parPHASEO_API_KEYdans chaque environnement ;- chaque identifiant de modèle de production figure dans
GET /v1/models?format=openai; - une requête sans streaming et une requête en streaming passent par
/v1/chat/completionsou/v1/responses, avec le même chemin client qu’en production ; - les flux d’appels d’outils et de sorties structurées passent avec de vrais prompts ;
- les échecs de clé invalide et de modèle invalide sont gérés ;
- une requête en échec peut être consultée avec
GET /v1/generations?id=<request_id>et, lorsquereplay_supportedvauttrue, relancée à partir dereplay_request; - les en-têtes et champs de réponse propres à OpenRouter sont supprimés ou normalisés, et les valeurs par défaut partagées se trouvent dans des préréglages.
Déployer
- Commencez par le trafic interne.
- Déplacez 5 à 10 % du trafic de production et comparez la qualité, la latence et le coût.
- Passez à 100 % une fois la parité confirmée.
- Gardez le retour arrière sous la forme d’un changement d’URL de base et de clé jusqu’à ce que la bascule soit stable.
Confier la migration à un agent de code
Donnez à l’agent cette séquence délimitée, ou installez la compétence de migration d’OpenRouter vers Phaseo, qui regroupe les mêmes étapes d’inventaire, de correspondance, de validation et de retour arrière :- Recherchez dans le code d’exécution et la configuration de déploiement
openrouter.ai,OPENROUTER_API_KEY,sk-or-v1,HTTP-RefereretX-Title. - Changez la frontière du client pour
https://api.phaseo.app/v1etPHASEO_API_KEYsans ajouter de valeur secrète au contrôle de version. - Interrogez
GET /v1/models?format=openaiet notez chaque correspondance entre ancien et nouveau modèle. - Adaptez les options de routage ou les champs de réponse propres à OpenRouter dans un seul module de compatibilité.
- Exécutez les vérifications de santé, sans streaming, en streaming et de chemin d’échec ci-dessus.
- Indiquez les fichiers modifiés, les changements de noms de secrets, les correspondances de modèles, les preuves de test, les écarts de parité et le mécanisme de retour arrière.