メインコンテンツへスキップ
OpenAI SDK はそのまま使い、ベース URL と API キーの 2 つだけを変更します。次に、各モデルに Phaseo の ID を指定します。Phaseo の ID には openai/ プレフィックスが付きます。

クライアントを切り替える

APIキーでキーを作成し、アプリを実行するすべての環境に追加します。次に、そのキーとベース URL を既存のクライアントに渡します。
Phaseo キーを OPENAI_API_KEY に入れるのではなく新しい変数名を使い、古い OPENAI_BASE_URL の値を削除して、リポジトリ内の他のクライアントが OpenAI を呼び出し続けないようにしてください。AzureOpenAI クライアントは通常の OpenAI クライアントに移行します。Azure のデプロイ名も同じ方法で Phaseo のモデル ID に対応付けます。

モデル ID を対応付ける

Phaseo が提供する ID を OpenAI の一覧形式で表示し、本番のすべてのモデルを data[].id と照合します。
format=openai を付けない場合、レスポンスは Phaseo のページ分割された models 一覧になり、data 配列はありません。client.models.list() でも同様で、Node では { query: { format: "openai" } }、Python では extra_query={"format": "openai"} を渡してください。既定の一覧には現在呼び出せるモデルのみが含まれます。非アクティブなモデルや近日公開のモデルも含めるには availability=all を追加します。

動作が異なる点

テストして展開する

同じ代表的なプロンプトを旧構成と新構成で実行し、出力の形式、レイテンシー、トークン使用量、エラー、コストを比較します。トラフィックを移す前に、次を確認してください。
  • 開発、ステージング、本番に Phaseo キーが設定されている
  • 本番のすべてのモデル ID が GET /v1/models?format=openai に表示される
  • ステージングで非ストリーミングとストリーミングのリクエストが通り、アプリが使う場合はツール呼び出しと構造化出力も通る
  • 切り戻しが引き続きベース URL とキーの変更だけで済む
その後、段階的にトラフィックを移します。フォールバックモデルについてはルーティングとフォールバックを、アプリが受け取る可能性のあるエラーのボディについてはエラー処理を参照してください。
最終更新日 2026年11月7日