Passer au contenu principal
Remplacez l’URL de base par 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

Gardez la charge utile inchangée lors du premier passage et obtenez la parité avant d’optimiser. Supprimez 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 :
La liste par défaut ne contient que les modèles que vous pouvez appeler maintenant ; ajoutez 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 :
Avant de déplacer une part importante du trafic, vérifiez que :
  • OPENROUTER_API_KEY est remplacée par PHASEO_API_KEY dans 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/completions ou /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, lorsque replay_supported vaut true, relancée à partir de replay_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

  1. Commencez par le trafic interne.
  2. Déplacez 5 à 10 % du trafic de production et comparez la qualité, la latence et le coût.
  3. Passez à 100 % une fois la parité confirmée.
  4. 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 :
  1. Recherchez dans le code d’exécution et la configuration de déploiement openrouter.ai, OPENROUTER_API_KEY, sk-or-v1, HTTP-Referer et X-Title.
  2. Changez la frontière du client pour https://api.phaseo.app/v1 et PHASEO_API_KEY sans ajouter de valeur secrète au contrôle de version.
  3. Interrogez GET /v1/models?format=openai et notez chaque correspondance entre ancien et nouveau modèle.
  4. Adaptez les options de routage ou les champs de réponse propres à OpenRouter dans un seul module de compatibilité.
  5. Exécutez les vérifications de santé, sans streaming, en streaming et de chemin d’échec ci-dessus.
  6. 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.
Pour une version guidée, ouvrez le guide interactif de migration depuis OpenRouter, voyez comment les deux se comparent ou obtenez une aide gratuite pour la migration.
Dernière modification le 5 novembre 2026