移行機能チェックリスト

既存のゲートウェイ統合のうち、そのまま移行できる部分と明示的な検証が必要な部分を、このチェックリストで確認します。最終確認日: 2026 年 8 月 23 日。

主なリクエストの互換性

機能	Phaseo の対応	移行時の対応
OpenAI 互換の認証	対応	ベース URL と API キーを変更し、認証付きリクエストを 1 件実行します。
Chat Completions	対応	通常、ストリーミング、ツール呼び出し、構造化出力のリクエストをテストします。
Responses	対応	入力形式、ストリーミングイベント、ツール、レスポンスの解析をテストします。
Anthropic Messages	対応	Anthropic 固有のヘッダー、システムプロンプト、ストリーミングイベントを確認します。
モデル識別子	Phaseo カタログ ID	本番で使うすべての ID を `GET /v1/models` で確認します。エイリアスが一致するとは限りません。
埋め込み・画像・音声エンドポイント	モデルとプロバイダーによる	切り替え前にモデルが必要な操作に対応していることを確認します。

ルーティングとポリシー制御

機能	Phaseo の対応	移行時の対応
プロバイダーの順序	`provider.order`	ワークロードで引き続き必要な順序ルールだけを再作成します。
プロバイダーの許可・除外リスト	`provider.only` と `provider.ignore`	プロバイダー ID を確認し、少なくとも 1 つのルートが利用可能であることを確かめます。
価格・レイテンシ・スループット順の並べ替え	`provider.sort`	テスト後に Gateway の使用状況で選択されたプロバイダーを確認します。
ゼロデータ保持	`provider.require_zero_data_retention`	要件を適用する前に、対応するプロバイダーがモデルにあることを確認します。
リージョン実行とデータレジデンシー	リクエストフィールドとワークスペースのプライバシー既定値	正常なルーティングと、該当するプロバイダーがない場合の失敗経路を両方テストします。
再利用可能なプロンプトと既定値	プリセット	共有設定を呼び出し元ごとに複製せず、プリセットにまとめます。

運用と展開

機能	Phaseo の対応	移行時の対応
リクエストの帰属情報	アプリ ID、名前、URL、カテゴリー	移行中も帰属情報ヘッダーを維持し、ダッシュボードでのアプリ分類を確認します。
リクエストとプロバイダーの詳細	Gateway の使用状況と生成レコード	代表的なプロンプトでプロバイダー、レイテンシ、トークン使用量、料金を比較します。
バッチと非同期ジョブ	バッチ、ファイル、動画、Webhook、WebSocket API	ステータス遷移、最終課金、キャンセル、結果取得を検証します。
リプレイ対応	生成レコードには利用可能な場合にリプレイ用メタデータが含まれる	失敗したリクエストから元のエンドポイントとペイロードを復元できることを確認します。
段階的な展開	クライアントまたはインフラでのトラフィック分割	切り替えが安定するまで、ベース URL と認証情報の変更だけでロールバックできるようにします。

ワークロードごとの検証が必要な機能

API の互換性だけで、次の動作が同じだと判断しないでください。

プロバイダーの自動選択とフォールバック順
プロンプトキャッシュの親和性と料金
プロバイダー固有のリクエストフィールド
レスポンス固有のメタデータ
レート制限と再試行のタイミング
データ保持、データレジデンシー、学習に関するポリシー
正確なモデルの提供状況と料金

本番に近いプロンプトと失敗ケースを試してから、まとまったトラフィックを移行します。

関連ガイド

最終更新日 2026年10月2日