https://api.phaseo.app/v1 und den Schlüssel in PHASEO_API_KEY. Anfrage-Payloads, der Header Authorization: Bearer, das provider-Objekt und das Fallback-Array models funktionieren weiter; prüfe die Modell-IDs und die wenigen Felder in der Tabelle unten.
Client umstellen
OPENROUTER_BASE_URL und den alten Schlüssel aus Code, CI und Hosting-Einstellungen. Aus @openrouter/ai-sdk-provider wird @phaseo/ai-sdk-provider (siehe Von Vercel AI Gateway migrieren); die eigenen SDKs von OpenRouter (@openrouter/sdk, openrouter auf PyPI) brauchen einen Client-Wechsel, nicht nur eine neue Basis-URL.
Modell-IDs prüfen
Die meisten IDs stimmen überein, einige Organisationen weichen aber ab:x-ai/ heißt spacex-ai/, meta-llama/ heißt meta/ und mistralai/ heißt mistral/. Liste die IDs von Phaseo auf und prüfe jedes Produktionsmodell dagegen:
availability=all hinzu, um inaktive oder demnächst verfügbare Modelle zu sehen. Ohne format=openai ist die Antwort die seitenweise models-Liste von Phaseo, die kein data-Array hat.
Anfragefelder zuordnen
Phaseo hat außerdem
provider.required_execution_region und provider.required_data_region, für die es bei OpenRouter keine Entsprechung gibt. Vollständige Anfragen findest du unter Anbieter pro Anfrage festlegen oder ignorieren und Nur an EU- oder ZDR-fähige Anbieter routen.
Behalte verbleibende OpenRouter-spezifische Felder in einem einzigen Adapter statt an jeder Aufrufstelle, damit das Zurückrollen eine Änderung von Basis-URL und Schlüssel bleibt.
Vor der Umstellung prüfen
Führe diese Prüfungen gegen Phaseo aus und dann dieselben Prüfungen über den eigenen Client-Pfad deiner App:OPENROUTER_API_KEYin jeder Umgebung durchPHASEO_API_KEYersetzt ist;- jede Produktions-Modell-ID in
GET /v1/models?format=openaisteht; - eine Anfrage ohne und eine mit Streaming über
/v1/chat/completionsoder/v1/responsesbestehen, über denselben Client-Pfad wie in der Produktion; - Abläufe mit Tool-Aufrufen und strukturierten Ausgaben mit echten Prompts bestehen;
- Fehler durch ungültige Schlüssel und ungültige Modelle behandelt werden;
- sich eine fehlgeschlagene Anfrage mit
GET /v1/generations?id=<request_id>nachschlagen und, wennreplay_supportedtrueist, ausreplay_requestwiederholen lässt; - OpenRouter-spezifische Header und Antwortfelder entfernt oder normalisiert sind und gemeinsame Standards in Presets liegen.
Umstellen
- Beginne mit internem Traffic.
- Verschiebe 5-10 % des Produktions-Traffics und vergleiche Qualität, Latenz und Kosten.
- Gehe auf 100 %, sobald die Gleichwertigkeit bestätigt ist.
- Halte das Zurückrollen als Wechsel von Basis-URL und Schlüssel bereit, bis die Umstellung stabil ist.
Die Migration an einen Coding-Agenten übergeben
Gib dem Agenten diese klar begrenzte Abfolge oder installiere den Skill für die Migration von OpenRouter zu Phaseo, der dieselben Schritte für Bestandsaufnahme, Zuordnung, Prüfung und Zurückrollen bündelt:- Durchsuche Laufzeitcode und Deployment-Konfiguration nach
openrouter.ai,OPENROUTER_API_KEY,sk-or-v1,HTTP-RefererundX-Title. - Stelle die Client-Grenze auf
https://api.phaseo.app/v1undPHASEO_API_KEYum, ohne einen geheimen Wert in die Versionskontrolle aufzunehmen. - Frage
GET /v1/models?format=openaiab und notiere jede Zuordnung von alter zu neuer Modell-ID. - Passe OpenRouter-spezifische Routing-Optionen oder Antwortfelder in einem einzigen Kompatibilitätsmodul an.
- Führe die oben genannten Prüfungen für Health, Anfragen ohne und mit Streaming sowie Fehlerpfade aus.
- Berichte über geänderte Dateien, geänderte Secret-Namen, Modellzuordnungen, Testnachweise, Lücken in der Gleichwertigkeit und den Schalter zum Zurückrollen.