メインコンテンツへスキップ
現在の Gateway 連携で使っている機能をそれぞれ探し、トラフィックを移す前に最後の列に書かれた作業を行ってください。最終確認日: 2026 年 11 月 4 日。 移行は次の順序で進めます。この順序なら、両方のプラットフォームが同じ OpenAI 互換リクエストを受け付ける場合でも、変わりうる動作を見つけられます。

連携の境界を棚卸しする

移行後に隠れた別の設定経路が残らないよう、現在の Gateway が登場する箇所をすべて記録します。
  • ベース URL と API キーの環境変数
  • SDK の初期化とカスタムヘッダー
  • モデル ID とフォールバックモデル
  • プロバイダーの順序、許可リスト、プライバシー要件
  • ストリーミング、ツール呼び出し、構造化出力のコード
  • バッチジョブ、ファイル、Webhook、非同期ステータスのポーリング
  • リクエストの帰属情報と、ユーザーまたはセッションのメタデータ

リクエスト

ルーティングとポリシー

運用

利用できない機能

次の機能には Phaseo の代替がありません。アプリ側か旧プラットフォームに残してください。
  • レスポンスキャッシュ。 Phaseo はレスポンスをキャッシュしません。プロンプトキャッシュでは引き続き入力コストを削減できます。
  • 保存されたレスポンスと会話。 GET や DELETE /v1/responses/{id} はありません。
  • トークンカウント(/v1/messages/count_tokens)。
  • OpenAI Assistants、Threads、ベクトルストア、ファインチューニング、旧来の /v1/completions。

各機能を分類する

上の表と移行元プラットフォームのガイドを使い、本番の各動作にステータスを 1 つずつ付けます。

自分のトラフィックで検証する

API の互換性があっても、次の点が同じ動作になるとは限りません。
  • 自動のプロバイダー選択とフォールバックの順序
  • プロンプトキャッシュのアフィニティとキャッシュ料金
  • プロバイダー固有のリクエストフィールドと、レスポンスのみのメタデータ
  • レート制限とリトライのタイミング
  • データ保持、レジデンシー、学習に関するポリシー
  • モデルの正確な提供状況と価格
機密性の高い本番データをコピーせずに、実際のワークロードのパターンから小さなテストセットを作り、次を実行します。
  1. 使用中のすべてのエンドポイントで通常のリクエストを 1 回
  2. 本番と同じクライアント経路でのストリーミング
  3. 現実的なスキーマでのツール呼び出しと構造化出力
  4. すべてのプロバイダー制約とプライバシー制約
  5. 無効なキー、無効なモデル、レート制限、プロバイダー利用不可の失敗
  6. 成功、失敗、キャンセルまでのバッチまたは非同期ジョブ
出力の品質、レイテンシー、トークン使用量、選ばれたプロバイダー、最終コストを比較します。各リクエスト ID を記録しておけば、リクエストログや GET /v1/generations?id=<request_id> で確認できます。

切り戻し可能なスイッチで展開する

まず開発用と社内のトラフィックから始めます。テストセットに合格してから本番の一部だけを移し、結果が安定するまで切り戻しはベース URL とキーの変更だけに留めます。切り替えをプロンプト、モデル、ルーティングの変更と同時に行わないでください。それらは Gateway の境界を検証した後に行います。
最終更新日 2026年11月5日