メインコンテンツへスキップ
AI SDK のコードでは、@ai-sdk/gateway を @phaseo/ai-sdk-provider に置き換え、各モデル ID を phaseo(...) で囲みます。OpenAI 互換のクライアントでは、ベース URL とキーを変更します。生成のロジックは変わりません。

プロバイダーを切り替える

既定の phaseo エクスポートは、モジュールのインポート時に PHASEO_API_KEY を一度だけ読み込み、https://api.phaseo.app/v1 を使います。一部のサーバーレス環境やテスト環境のように、インポート後に変数を設定すると、すべての呼び出しがキー未設定のエラーをスローします。その場合は、ハンドラー内で createPhaseo({ apiKey, baseURL, headers }) を呼び出してください。 ai のメジャーバージョンに合ったプロバイダーをインストールします。AI SDK 7 には @phaseo/ai-sdk-provider、AI SDK 6 には @phaseo/ai-sdk-provider@ai-sdk-v6、AI SDK 5 には @phaseo/ai-sdk-provider@ai-sdk-v5 を使います。 AI SDK は、文字列のみのモデル指定(model: "openai/gpt-4.1-mini")を既定で Vercel の Gateway に送るため、文字列のまま残った指定は Vercel を呼び出し続けます。共有のモデルファクトリを一度変更してから、AI SDK の呼び出しで model: " を検索してください。ai-gateway.vercel.sh に向けた Anthropic SDK のクライアントは、Anthropic SDK からの移行の設定に移します。

Gateway のオプションを対応付ける

providerOptions.phaseo はリクエストのボディにマージされます。残った providerOptions.gateway はエラーにならずに無視されます。

テストして展開する

同じプロンプトセットを両方の経路で実行し、レイテンシー、出力形式、トークン使用量を比較します。トラフィックを移す前に、次を確認してください。
  • Gateway キーがあったすべてのランタイム(エッジ、サーバー、プレビューのデプロイを含む)に PHASEO_API_KEY が設定されている
  • ステージングで、主要なテキスト生成の経路と 1 つのストリーミングテストが変更なしで通る
  • アプリが使う場合は、ツール呼び出しと構造化出力が通る
  • アプリケーションレベルのエラーの対応付けが引き続き機能する
  • ステージングで失敗したリクエストを見つけられ、replay_supported が true の場合は GET /v1/generations?id=<request_id> からリプレイできる
機能フラグまたは割合指定の展開を使い、社内のトラフィックから出荷します。レイテンシー、エラー率、トークンとコストのずれを監視し、切り戻しにコード変更が要らないよう、少なくとも 1 リリースの間は旧プロバイダーを使える状態にしておきます。
プロバイダーの詳細は AI SDK を参照してください。
最終更新日 2026年11月7日