OpenRouter から Phaseo への移行

​

変更点

1. payload の形式を維持する。
2. ベース URL と API キーの参照元を切り替える。
3. モデル ID と OpenRouter 固有のヘッダーを確認する。
4. トラフィックを段階的に移し、レイテンシ、出力、コストを比較する。

​

開始前の準備

• 現在の OpenRouter 統合コードとデプロイ設定へのアクセス。
• 開発、ステージング、本番環境で PHASEO_API_KEY を利用できること。
• 本番で使うモデル ID と代表的なプロンプトの短い一覧。

​

1) OpenRouter の現在の使用箇所を洗い出す

• openrouter.ai のエンドポイントを検索します。
• コード、CI、ホスティング環境変数から OPENROUTER_API_KEY を検索します。
• HTTP-Referer や X-Title など OpenRouter 固有のヘッダーを検索します。
• 有効なモデル ID とフォールバックのロジックを記録します。
• アプリ内で重複させず Gateway のプリセットに移すべき、共有プロンプト、プロバイダー、パラメーターの既定値を特定します。

​

2) ベース URL と認証情報を切り替える

// 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) モデル ID を検証し、OpenRouter 固有の動作を対応付ける

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

• Authorization: Bearer の形式を維持します。
• 呼び出し元アプリの識別に使う場合は HTTP-Referer と X-Title を維持します。Phaseo は小文字の http-referer と x-title も受け付けます。
• OpenRouter 固有の応答フィールドに依存する呼び出し元がある場合は、1 つの互換レイヤーで対応します。
• 許可・拒否プロバイダーリストやルーティング既定値は、呼び出し側に散在させずプリセットとルーティングとフォールバックに移します。

​

プロバイダー制御を対応付ける

​

4) OpenRouter との同等性チェックリスト

• ベース URL を https://api.phaseo.app/v1 に更新した。
• すべての環境で OPENROUTER_API_KEY を PHASEO_API_KEY に置き換えた。
• 本番のすべてのモデル ID を /v1/models で確認した。
• /v1/chat/completions または /v1/responses で非ストリーミング要求を検証した。
• 本番と同じアプリ統合経路でストリーミング要求を検証した。
• GET /v1/generations?id=<request_id> を再確認した。replay_supported=true の場合、保存された replay_request から失敗した要求を再実行できます。
• 実際のプロンプトでツール呼び出しと構造化出力を再確認した。
• ステージングで無効なキーとモデルのエラーを確認した。
• OpenRouter 固有のヘッダーや応答フィールドを削除、または明示的に正規化した。
• 共有プロンプトやルーティングの既定値を必要に応じてプリセットに移した。

​

エージェント向け移行チェックリスト

1. 実行コードとデプロイ設定から openrouter.ai、OPENROUTER_API_KEY、sk-or-v1、HTTP-Referer、X-Title を検索する。
2. 秘密値をソース管理に追加せず、クライアント境界を https://api.phaseo.app/v1 と PHASEO_API_KEY に変更する。
3. GET /v1/models を照会し、旧モデルから新モデルへの対応表を記録する。
4. OpenRouter 固有のルーティング設定や応答フィールドを、1 つの互換モジュールで調整する。
5. 下記の health、models、通常要求、streaming、エラー経路を確認する。
6. 変更ファイル、シークレット名の変更、モデル対応表、テスト結果、同等性の差、ロールバック方法を報告する。

​

5) 安全に段階展開する

1. 最初は社内トラフィックだけで始めます。
2. 本番の 5〜10% に増やし、品質、レイテンシ、コストを比較します。
3. 同等性を確認できたら 100% に増やします。
4. 切り替えが安定するまで、URL とキーだけで戻せるようにします。

​

検証コマンド

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

• アプリの統合テスト経由でストリーミング要求を 1 件実行します。
• 無効なキーまたはモデルの異常系テストを実行します。
• 小さな基準プロンプトセットを再実行し、出力を比較します。

​

次のステップ

• OpenRouter 連携の移行支援を無料で依頼する
• OpenRouter 移行ガイドを開く
• Phaseo と OpenRouter を比較する
• クイックスタート
• API リファレンス：モデル
• サンプル
• エラー処理