Von OpenRouter zu Phaseo migrieren

​

Was sich ändert

1. Payload-Format beibehalten.
2. Basis-URL und Quelle des API-Schlüssels austauschen.
3. Modell-IDs und OpenRouter-spezifische Header prüfen.
4. Traffic schrittweise umstellen und Latenz, Ausgabe und Kosten vergleichen.

​

Vor dem Start

• Zugriff auf den aktuellen OpenRouter-Integrationscode und die Deployment-Konfiguration.
• PHASEO_API_KEY in Entwicklung, Test und Produktion.
• Eine kurze Liste der Produktionsmodell-IDs und repräsentative Prompts.

​

1) Bisherige OpenRouter-Nutzung erfassen

• Suchen Sie nach openrouter.ai-Endpunkten.
• Suchen Sie im Code, in CI und Hosting-Variablen nach OPENROUTER_API_KEY.
• Suchen Sie nach OpenRouter-spezifischen Headern wie HTTP-Referer und X-Title.
• Dokumentieren Sie aktive Modell-IDs und Fallback-Logik.
• Finden Sie wiederverwendbare Prompt-, Anbieter- oder Parameterstandards, die in Gateway-Voreinstellungen gehören, statt im Anwendungscode dupliziert zu werden.

​

2) Basis-URL und Zugangsdaten austauschen

// 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) Modell-IDs prüfen und OpenRouter-spezifisches Verhalten abbilden

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

• Behalten Sie das Format Authorization: Bearer bei.
• Behalten Sie HTTP-Referer und X-Title bei, wenn sie die aufrufende Anwendung kennzeichnen. Phaseo akzeptiert auch die kleingeschriebenen Varianten http-referer und x-title.
• Passen Sie OpenRouter-spezifische Antwortfelder, von denen Aufrufer abhängen, in einer einzigen Kompatibilitätsschicht an.
• Übertragen Sie Anbieter-Positiv-/Negativlisten und Routingvorgaben zu Voreinstellungen und Routing und Fallbacks.

​

Anbietersteuerung zuordnen

​

4) Checkliste für OpenRouter-Parität

• Basis-URL auf https://api.phaseo.app/v1 aktualisiert.
• OPENROUTER_API_KEY in allen Umgebungen durch PHASEO_API_KEY ersetzt.
• Alle Produktionsmodell-IDs mit /v1/models geprüft.
• Eine Anfrage ohne Streaming über /v1/chat/completions oder /v1/responses getestet.
• Eine Streaminganfrage über denselben Integrationspfad wie in der Produktion getestet.
• GET /v1/generations?id=<request_id> erneut geprüft, damit Fehler bei replay_supported=true aus der gespeicherten replay_request wiederholt werden können.
• Tool-Aufrufe und strukturierte Ausgaben mit echten Prompts erneut geprüft.
• Fehler wegen ungültigem Schlüssel oder Modell in der Testumgebung geprüft.
• OpenRouter-spezifische Header oder Antwortfelder entfernt oder ausdrücklich normalisiert.
• Gemeinsame Prompt- und Routingstandards bei Bedarf in Voreinstellungen verschoben.

​

Migrations-Checkliste für einen Agenten

1. Durchsuchen Sie Laufzeitcode und Deployment-Konfiguration nach openrouter.ai, OPENROUTER_API_KEY, sk-or-v1, HTTP-Referer und X-Title.
2. Ändern Sie die Client-Anbindung auf https://api.phaseo.app/v1 und PHASEO_API_KEY, ohne Geheimnisse im Repository abzulegen.
3. Rufen Sie GET /v1/models ab und dokumentieren Sie jede Modellzuordnung.
4. Passen Sie OpenRouter-spezifische Routingoptionen oder Antwortfelder in einem Kompatibilitätsmodul an.
5. Führen Sie die untenstehenden Prüfungen für Health, Modelle, normale Anfragen, Streaming und Fehler aus.
6. Berichten Sie geänderte Dateien, Secret-Umbenennungen, Modellzuordnungen, Testergebnisse, Paritätslücken und Rollback-Schalter.

​

5) Sicher ausrollen

1. Beginnen Sie nur mit internem Traffic.
2. Erhöhen Sie auf 5–10 % des Produktionsverkehrs und vergleichen Sie Qualität, Latenz und Kosten.
3. Wechseln Sie erst nach bestätigter Parität auf 100 %.
4. Halten Sie den Rollback bis zur Stabilisierung auf einen Wechsel von URL und Schlüssel beschränkt.

​

Validierungsbefehle

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"}]}'

• Führen Sie eine Streaminganfrage über den Integrationstest der Anwendung aus.
• Testen Sie einen ungültigen Schlüssel oder ein ungültiges Modell.
• Spielen Sie einen kleinen Referenz-Promptdatensatz erneut ab und vergleichen Sie die Ausgaben.

​

Nächste Schritte

• Kostenlose Hilfe zur Migration Ihrer OpenRouter-Integration erhalten
• Interaktiven OpenRouter-Migrationsleitfaden öffnen
• Phaseo und OpenRouter vergleichen
• Schnellstart
• API-Referenz: Modelle
• Beispiele
• Fehlerbehandlung