一把 key 呼叫數百個模型：Vercel AI Gateway 實作教學，官方說 token 零加價（2026-09-07 文件版）

如果你手上同時有 OpenAI、Anthropic、Google 的 API key，每換一家就要改一次程式，Vercel AI Gateway 是來解這件事的：一把 key，數百個模型。 本文依官方文件（頁面標示最後更新 2026-09-07）於 2026-09-08 整理。

一、最短可跑的例子

官方文件給的 curl 就是最直接的起點：

curl https://ai-gateway.vercel.sh/v1/chat/completions \
  -H "Authorization: Bearer $AI_GATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-6-astra",
    "messages": [
      {
        "role": "user",
        "content": "Invent a new holiday and describe its traditions."
      }
    ]
  }'

三個要記住的點：

1. Base URL：https://ai-gateway.vercel.sh/v1/chat/completions
2. 驗證：Authorization: Bearer <你的 AI_GATEWAY_API_KEY>
3. 模型寫法：供應商/模型名，例如 openai/gpt-6-astra、anthropic/claude-sonnet-5

換模型＝改字串。 這是整套東西的重點——不是改 SDK、不是換 base URL、不是重寫驗證。

二、它相容三種介面（不用重寫既有程式）

官方列出可用的介面：

第二、四項是最實際的：你不用改程式邏輯，只要把 base URL 與 key 換掉。

三、關於錢：官方寫「零加價」

這是文件裡最值得引的一句：「No markup on tokens. Tokens cost the same as they would from the provider directly, with zero markup, including with Bring Your Own Key (BYOK).」

翻成人話：透過 Gateway 呼叫，token 的價格跟你直接跟模型商買一樣，包含你自帶金鑰的情況。

對照本站同日查核的另一個工具：Zed 的超額是「API 牌價 +10%」。兩種模式沒有好壞，但你要知道自己在哪一種。

⚠️ 提醒：零加價是指 token 本身。文件另有獨立的 AI Gateway pricing 頁面，提到 token 成本、額度（credits）、附加費用與付款手續費——手續費那一項不等於零。要精算成本的人，請直接讀那一頁，不要只看這句宣傳語。

四、上線前一定要做的兩件事

1. 設預算上限

文件明列 Budgets and spend limits，可以對團隊、專案、API key、使用者分別設定支出上限與警示。

這件事要在寫第一行程式之前做。 一把能呼叫數百個模型的 key，如果外洩或程式寫出無窮迴圈，沒有上限就是沒有煞車。

2. 處理 429

文件有獨立的 Rate limits 章節，說明請求上限與 429 回應的處理。

最低限度：你的程式收到 429 要退避重試，不要直接當成錯誤丟掉，也不要無間隔狂打。

五、進階：一次接多家的兩個實際好處

官方列的能力裡，有兩項是「一把 key」以外真正的理由：

• 高可靠度：某一家掛掉時，自動改送到其他供應商。這是自己接單一供應商做不到的。
• 支出監控：跨供應商看總花費。多家分開接的人通常要月底對三張帳單才知道花多少。

另外文件也提到可以直接接 coding agent：

vercel ai-gateway coding-agents setup

六、什麼時候不該用它

誠實講清楚：

• 你只用一家模型、而且不打算換 → 直接接原廠更單純，少一層。
• 你有資料流向的合規限制 → 多一層代理就是多一個要審的環節，文件另有 Security and compliance 章節（資料保留、prompt 訓練政策、模型與供應商存取控制）要先讀。
• 你需要某家最新功能的第一天支援 → 中介層通常會晚一點。

七、五分鐘上手順序

1. 在 Vercel 取得 AI Gateway API key，設成環境變數 AI_GATEWAY_API_KEY。
2. 用第一節那段 curl 打通第一次呼叫。
3. 先去設預算上限（第四節），再開始寫程式。
4. 既有程式改 base URL 與 key，跑一次回歸測試。
5. 想換模型時，只改 model 字串試試看——這是這套東西最值得驗證的一件事。

限時免費／折扣模型的死線要注意，見 Vercel AI Gateway 的折扣與死線；目前還在期間內的免費模型，見 Ling 3.0 Flash Sante 免費到 10/4。

本文依據 Vercel 官方文件 Vercel AI Gateway（頁面標示 last_updated 2026-09-07）於 2026-09-08 直讀整理。base URL、curl 範例、模型命名格式、四種相容介面、「token 零加價（含 BYOK）」、預算上限、rate limits 與 vercel ai-gateway coding-agents setup 皆為官方文件所載。本站未實際建立帳號測試呼叫；官方另有獨立計價頁說明 credits 與付款手續費，本站未逐項查核其金額，讀者精算前請自行核對。 第六節為本站建議。