Vercel AI Gatewayの使い方｜複数のAIを同じAPIから呼び出す

AIアプリでモデルを変えるたびに、接続設定や利用状況の確認場所がばらばらになっていませんか。Vercel AI Gatewayは、いくつものモデル提供元をひとつの窓口につなぎ、リクエストごとの利用状況も確認できる仕組みです。Vercel以外のサーバーからもAPIキーで利用できます。

小さな問い合わせ分類アプリで試す

たとえば「この問い合わせは予約変更・設備・その他のどれか」と分類する機能を作ります。まずは同じテスト文を複数モデルに送って、回答の分かりやすさ・速さ・料金を比べます。実運用へ切り替える前に、個人情報を含まないテスト内容で動きを確かめます。

最初の呼び出し

1. 1ダッシュボードでAPIキーを作る

   VercelのAI Gateway画面からキーを作成します。APIキーは環境変数へ保存し、Gitへ追加しないでください。Vercel以外の環境からの呼び出しにもAPIキーを使えます。

2. 2開発環境にキーを設定する

   Next.jsなどのサーバー側で使う例です。実際の値は自分の端末の .env.local に入れ、共有・公開しません。

   この手順で使う入力例

   AI_GATEWAY_API_KEY=自分のAPIキー

3. 3既存のOpenAI SDKから試す

   OpenAI互換APIの例です。モデル名は公式モデル一覧の現在のIDに置き換えます。

   この手順で使う入力例

   const client = new OpenAI({ apiKey: process.env.AI_GATEWAY_API_KEY, baseURL: 'https://ai-gateway.vercel.sh/v1' });
   const result = await client.chat.completions.create({ model: 'provider/model-id', messages: [{ role: 'user', content: 'テスト用の問い合わせ' }] });

4. 4ログで利用状況を見る

   VercelのAI Gateway Logsでは、費用、トークン数、処理時間、使われたモデル・提供元・地域などをリクエストごとに確認できます。急に遅くなったり費用が増えたりしたとき、調べる手掛かりになります。

無料クレジットとAPI料金

月$5分のクレジットがあるから、Vercel全体が無料になるわけではありません。AI Gatewayを使うモデル代の枠であり、Vercelのホスティングや追加機能の料金は別です。クレジットを買うと月次無料分がなくなるという条件も、利用前に確認してください。

OpenRouterと何が違う？

OpenRouterも複数モデルを同じAPIから利用できます。OpenRouterは多くのモデルを探して試す窓口として分かりやすく、Vercel AI GatewayはVercelの開発環境・AI SDK・チームのログ画面と合わせたい人に向きます。どちらもAPI経由でモデル提供元へ内容を送るため、プライバシー条件はモデル提供元ごとに確かめる必要があります。