Zum Hauptinhalt springen
Ändere die Basis-URL in 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

Lass die Payload im ersten Durchgang unverändert und stelle Gleichwertigkeit her, bevor du optimierst. Entferne 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:
Die Standardliste enthält nur Modelle, die du jetzt aufrufen kannst; füge 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:
Bevor du nennenswerten Traffic verschiebst, prüfe, dass:
  • OPENROUTER_API_KEY in jeder Umgebung durch PHASEO_API_KEY ersetzt ist;
  • jede Produktions-Modell-ID in GET /v1/models?format=openai steht;
  • eine Anfrage ohne und eine mit Streaming über /v1/chat/completions oder /v1/responses bestehen, ü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, wenn replay_supported true ist, aus replay_request wiederholen lässt;
  • OpenRouter-spezifische Header und Antwortfelder entfernt oder normalisiert sind und gemeinsame Standards in Presets liegen.

Umstellen

  1. Beginne mit internem Traffic.
  2. Verschiebe 5-10 % des Produktions-Traffics und vergleiche Qualität, Latenz und Kosten.
  3. Gehe auf 100 %, sobald die Gleichwertigkeit bestätigt ist.
  4. 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:
  1. Durchsuche Laufzeitcode und Deployment-Konfiguration nach openrouter.ai, OPENROUTER_API_KEY, sk-or-v1, HTTP-Referer und X-Title.
  2. Stelle die Client-Grenze auf https://api.phaseo.app/v1 und PHASEO_API_KEY um, ohne einen geheimen Wert in die Versionskontrolle aufzunehmen.
  3. Frage GET /v1/models?format=openai ab und notiere jede Zuordnung von alter zu neuer Modell-ID.
  4. Passe OpenRouter-spezifische Routing-Optionen oder Antwortfelder in einem einzigen Kompatibilitätsmodul an.
  5. Führe die oben genannten Prüfungen für Health, Anfragen ohne und mit Streaming sowie Fehlerpfade aus.
  6. Berichte über geänderte Dateien, geänderte Secret-Namen, Modellzuordnungen, Testnachweise, Lücken in der Gleichwertigkeit und den Schalter zum Zurückrollen.
Für eine geführte Version öffne den interaktiven OpenRouter-Migrationsleitfaden, sieh dir an, wie sich die beiden im Vergleich schlagen, oder hol dir kostenlose Hilfe bei der Migration.
Zuletzt geändert am 5. November 2026