@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>からリプレイできる