https://api.phaseo.app/v1 に、キーを PHASEO_API_KEY に変更します。リクエストのペイロード、Authorization: Bearer ヘッダー、provider オブジェクト、models フォールバック配列はそのまま動作します。モデル ID と、下の表にあるいくつかのフィールドを確認してください。
クライアントを切り替える
OPENROUTER_BASE_URL と古いキーを削除します。@openrouter/ai-sdk-provider は @phaseo/ai-sdk-provider に置き換えます(Vercel AI Gateway からの移行を参照)。OpenRouter 独自の SDK(@openrouter/sdk、PyPI の openrouter)は、ベース URL の変更だけでなくクライアントの変更が必要です。
モデル ID を確認する
ほとんどの ID は一致しますが、一部の org は異なります。x-ai/ は spacex-ai/、meta-llama/ は meta/、mistralai/ は mistral/ です。Phaseo の ID を一覧表示し、本番の各モデルと照合します。
availability=all を追加します。format=openai を付けない場合、レスポンスは Phaseo のページ分割された models 一覧になり、data 配列はありません。
リクエストフィールドを対応付ける
Phaseo には
provider.required_execution_region と provider.required_data_region もあり、これらに相当するものは OpenRouter にはありません。完全なリクエスト例は、プロバイダーを固定または除外するとEU または ZDR 対応のプロバイダーにのみルーティングするを参照してください。
切り戻しがベース URL とキーの変更で済むよう、残った OpenRouter 専用のフィールドは呼び出し箇所ごとではなく、1 つのアダプターにまとめてください。
切り替え前に検証する
次のコマンドを Phaseo に対して実行し、続いて同じ確認をアプリ自身のクライアント経路で行います。- すべての環境で
OPENROUTER_API_KEYがPHASEO_API_KEYに置き換えられている - 本番のすべてのモデル ID が
GET /v1/models?format=openaiにある - 本番と同じクライアント経路を使い、
/v1/chat/completionsまたは/v1/responsesで非ストリーミングとストリーミングのリクエストが通る - 実際のプロンプトでツール呼び出しと構造化出力のフローが通る
- 無効なキーと無効なモデルの失敗を処理している
- 失敗したリクエストを
GET /v1/generations?id=<request_id>で調べられ、replay_supportedがtrueの場合はreplay_requestからリプレイできる - OpenRouter 専用のヘッダーとレスポンスフィールドが削除または正規化され、共有の既定値がプリセットにまとまっている
展開する
- 社内のトラフィックから始めます。
- 本番トラフィックの 5〜10% を移し、品質、レイテンシー、コストを比較します。
- 同等であることを確認したら 100% に引き上げます。
- 切り替えが安定するまで、切り戻しはベース URL とキーの切り替えで済むようにしておきます。
移行をコーディングエージェントに任せる
エージェントには次の範囲を限定した手順を渡すか、同じ棚卸し、対応付け、検証、切り戻しの手順をまとめた OpenRouter から Phaseo への移行スキルをインストールしてください。- ランタイムのコードとデプロイ設定から
openrouter.ai、OPENROUTER_API_KEY、sk-or-v1、HTTP-Referer、X-Titleを検索します。 - ソース管理にシークレットの値を追加せずに、クライアントの境界を
https://api.phaseo.app/v1とPHASEO_API_KEYに変更します。 GET /v1/models?format=openaiを照会し、旧モデルから新モデルへの対応付けをすべて記録します。- OpenRouter 専用のルーティングオプションやレスポンスフィールドを、1 つの互換モジュールで変換します。
- 上記のヘルスチェック、非ストリーミング、ストリーミング、失敗経路の確認を実行します。
- 変更したファイル、シークレット名の変更、モデルの対応付け、テストの証跡、同等性のギャップ、切り戻しのスイッチを報告します。