Migrer d’OpenRouter vers Phaseo

​

Ce qui change

1. Conserver la structure du corps de la requête.
2. Remplacer l’URL de base et la source de la clé API.
3. Vérifier les identifiants de modèles et les en-têtes propres à OpenRouter.
4. Augmenter le trafic progressivement en comparant latence, sorties et coûts.

​

Avant de commencer

• Accès au code d’intégration OpenRouter actuel et à la configuration de déploiement.
• PHASEO_API_KEY disponible en développement, en test et en production.
• Une courte liste d’identifiants de modèles de production et de prompts représentatifs.

​

1) Inventoriez l’utilisation actuelle d’OpenRouter

• Recherchez les endpoints openrouter.ai.
• Recherchez OPENROUTER_API_KEY dans le code, la CI et les variables d’environnement d’hébergement.
• Repérez les en-têtes propres à OpenRouter, comme HTTP-Referer et X-Title.
• Documentez les identifiants de modèles actifs et la logique de repli.
• Identifiez les valeurs réutilisables de prompts, fournisseurs ou paramètres à déplacer vers des préréglages Gateway au lieu de les dupliquer dans le code.

​

2) Remplacez l’URL de base et les identifiants

// Before
import OpenAI from "openai";

const before = new OpenAI({
  apiKey: process.env.OPENROUTER_API_KEY,
  baseURL: "https://openrouter.ai/api/v1",
});

const response = await before.chat.completions.create({
  model: "openai/gpt-4.1-mini",
  messages: [{ role: "user", content: "Summarize our migration plan." }],
});

// After
import OpenAI from "openai";

const after = new OpenAI({
  apiKey: process.env.PHASEO_API_KEY,
  baseURL: "https://api.phaseo.app/v1",
});

const response = await after.chat.completions.create({
  model: "openai/gpt-4.1-mini",
  messages: [{ role: "user", content: "Summarize our migration plan." }],
});

# Before
curl -s "https://openrouter.ai/api/v1/chat/completions" \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4.1-mini",
    "messages": [{"role":"user","content":"Say hello"}]
  }'

# After
curl -s "https://api.phaseo.app/v1/chat/completions" \
  -H "Authorization: Bearer $PHASEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4.1-mini",
    "messages": [{"role":"user","content":"Say hello"}]
  }'

​

3) Validez les identifiants de modèles et adaptez les fonctions propres à OpenRouter

curl -s "https://api.phaseo.app/v1/models" \
  -H "Authorization: Bearer $PHASEO_API_KEY" | jq '.data[0:10] | map(.id)'

• Conservez le format Authorization: Bearer.
• Gardez HTTP-Referer et X-Title s’ils identifient l’application appelante. Phaseo accepte aussi les équivalents en minuscules http-referer et x-title.
• Si des appelants dépendent de champs de réponse propres à OpenRouter, adaptez-les dans une seule couche de compatibilité.
• Si votre configuration utilise des listes de fournisseurs autorisés ou interdits et des règles de routage, déplacez-les vers Préréglages et Routage et solutions de repli.

​

Faites correspondre les contrôles de fournisseurs

​

4) Liste de contrôle de parité avec OpenRouter

• L’URL de base est https://api.phaseo.app/v1.
• OPENROUTER_API_KEY a été remplacée par PHASEO_API_KEY dans tous les environnements.
• Tous les identifiants de modèles de production ont été vérifiés avec /v1/models.
• Une requête sans streaming fonctionne via /v1/chat/completions ou /v1/responses.
• Une requête avec streaming fonctionne via le même parcours d’intégration applicatif qu’en production.
• Les recherches GET /v1/generations?id=<request_id> ont été revérifiées pour rejouer les échecs depuis replay_request lorsque replay_supported=true.
• Les appels d’outils et les sorties structurées ont été revérifiés avec de vrais prompts.
• Les erreurs de clé et de modèle invalides ont été vérifiées en environnement de test.
• Les en-têtes et champs de réponse propres à OpenRouter ont été supprimés ou explicitement normalisés.
• Les valeurs partagées de prompts et de routage ont été déplacées vers des préréglages si nécessaire.

​

Liste de migration pour un agent

1. Recherchez openrouter.ai, OPENROUTER_API_KEY, sk-or-v1, HTTP-Referer et X-Title dans le code et la configuration de déploiement.
2. Passez à https://api.phaseo.app/v1 et PHASEO_API_KEY sans enregistrer de secret dans le dépôt.
3. Consultez GET /v1/models et consignez chaque correspondance entre anciens et nouveaux modèles.
4. Adaptez les options de routage ou champs de réponse propres à OpenRouter dans un seul module de compatibilité.
5. Effectuez les vérifications de santé, modèles, requêtes sans streaming, streaming et erreurs ci-dessous.
6. Signalez les fichiers modifiés, changements de noms de secrets, correspondances, preuves de test, écarts de parité et mécanisme de retour arrière.

​

5) Déployez sans risque

1. Commencez uniquement avec le trafic interne.
2. Passez à 5–10 % du trafic de production et comparez qualité, latence et coûts.
3. Passez à 100 % après confirmation de la parité.
4. Gardez le retour arrière limité à un changement d’URL et de clé jusqu’à stabilisation.

​

Commandes de validation

curl -s "https://api.phaseo.app/v1/health"
curl -s "https://api.phaseo.app/v1/models" -H "Authorization: Bearer $PHASEO_API_KEY"
curl -s "https://api.phaseo.app/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $PHASEO_API_KEY" \
  -d '{"model":"openai/gpt-4.1-mini","messages":[{"role":"user","content":"Say hello"}]}'

curl -N "https://api.phaseo.app/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $PHASEO_API_KEY" \
  -d '{"model":"openai/gpt-4.1-mini","stream":true,"messages":[{"role":"user","content":"Reply with: stream works"}]}'

curl -s "https://api.phaseo.app/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $PHASEO_API_KEY" \
  -d '{"model":"invalid/migration-test","messages":[{"role":"user","content":"test"}]}'

• Exécutez une requête avec streaming via le test d’intégration applicatif.
• Effectuez un test négatif avec une clé ou un modèle invalide.
• Rejouez un petit jeu de prompts de référence et comparez les sorties.

​

Étapes suivantes

• Obtenir gratuitement de l’aide pour migrer votre intégration OpenRouter
• Ouvrir le guide interactif de migration OpenRouter
• Comparer Phaseo et OpenRouter
• Démarrage rapide
• Référence API : modèles
• Exemples
• Gestion des erreurs