台灣打造的 AI・什麼都可以問──免費試試 TheAI 對話,最懂台灣

OpenRouter 完整教學:一組 API key 打通 364 個模型,儲值、路由、省錢全攻略

OpenRouter 完整教學:一組 API key 打通 364 個模型,儲值、路由、省錢全攻略

OpenRouter 用一個端點聚合數百個 AI 模型且推論不加價。本文從註冊儲值、建立金鑰、第一次 API 呼叫,到 auto-beta 自動選模、供應商路由與 BYOK 進階玩法,含台灣開發者最容易踩的雷。

凌晨一點,一位台北的獨立開發者盯著螢幕嘆氣:他的 side project 同時要接三家模型——寫程式用 Claude、便宜的批次任務用 DeepSeek、偶爾想試試新出的開源模型。三組 API key、三種計費儀表板、三份 SDK 文件,光是管理金鑰就快把熱情磨光。後來他把整個專案改接 OpenRouter,程式碼只改了一行 base_url,三家變一家。這篇就把這條路怎麼走,一步一步講清楚。

OpenRouter 是什麼

OpenRouter 是一個「模型聚合閘道」:你只需要一組 API key、一個端點(openrouter.ai/api/v1),就能呼叫上面數百個模型。我在 2026 年 7 月底實際打了一次它的 models API,回傳 364 個模型、來自 57 個模型作者——OpenAI 70 個、Qwen 48 個、Google 39 個、Anthropic 26 個,連 MiniMax、Moonshot 這些中國模型廠都在列。

最關鍵的一點:它的推論計價是「原價轉售」,不在模型費率上加價,賺的是儲值手續費(刷卡 5.5%、加密貨幣 5%)。所以你不用擔心「透過它呼叫比較貴」,該擔心的只有儲值時那筆手續費。

能做什麼

對開發者來說,它解決三件事:一是免去多家帳號管理,一組 key 走天下;二是自動容錯,某家供應商掛了會自動切到備援;三是成本可視化,每個回應都直接附上這次花了多少 token、多少錢,不用事後對帳。

因為它的 API 完全相容 OpenAI 格式,你手上任何用 OpenAI SDK 寫的程式,把 base_url 換成 OpenRouter 的端點就能用,ClaudeChatGPT 系列模型都直接呼叫得到。

怎麼用:五步上手

  1. 註冊與儲值:到 openrouter.ai 註冊,先儲值。這裡有個實用門檻——累積儲值滿 10 美元,免費模型的每日額度會從 50 次跳到 1,000 次,建議一開始就儲 10 美元。
  2. 建立 API key:到 Keys 頁面建一把金鑰,可以幫每把 key 設「額度上限」,side project 超支自動斷線,這功能我大推。
  3. 挑模型:模型代號是「作者/模型名」格式,例如 openai/gpt-5.1。想免費測試就找結尾帶 :free 的模型,目前有 14 個。
  4. 發出第一個請求:對 openrouter.ai/api/v1/chat/completions 發 POST,帶上 Bearer token 就行;用 Python 的話直接拿 OpenAI SDK、改 base_url 即可。
  5. 看用量:回應裡自帶 usage 物件,含 token 數與實際成本;網站儀表板也能按 key、按模型看花費。

進階技巧

  • 自動選模:用 openrouter/auto-beta 讓系統依任務類型幫你挑模型,還能用 cost_quality_tradeoff 參數在品質與成本間調整(0 最重品質、10 最省錢)。舊的 openrouter/auto 已棄用,別再照舊教學設了。
  • 供應商路由:在請求裡加 provider 物件,可以指定供應商順序、按價格或延遲排序;懶人版是在模型代號後面加 :nitro(衝速度)或 :floor(衝低價)。
  • 隱私控制:設 data_collection: "deny" 或 zdr: true,只路由到不保留資料的端點,處理敏感資料時很重要。
  • BYOK:自己手上有 OpenAI 或 Anthropic 的企業額度?可以把自家 key 掛上去,每月前 100 萬次請求免手續費,之後收 5%。細節可以搭配我們的 BYOK 金鑰管理指南 服用。

注意事項

儲值手續費是唯一的「隱形成本」,5% 起跳、刷卡最低收 0.8 美元,小額頻繁儲值很吃虧,建議一次儲足。另外,餘額變負數時會全面回 402 錯誤——連免費模型都不能用,這點蠻多人踩雷。還有,同一個模型在不同供應商端點的量化精度可能不同,輸出品質有落差,在意的話用 quantizations 參數鎖定。如果你偏好自架的閘道方案,LiteLLMPortkey 是另一條路,但維運成本要自己扛。

TheAI學院 總結與評語

評語:對台灣獨立開發者和小團隊來說,OpenRouter 是目前「多模型接入」摩擦最低的選擇——一行 base_url 換來 364 個模型與自動容錯,儲值手續費就當付保護費。

我自己的建議:先儲 10 美元解鎖免費模型額度,用 :free 模型把流程跑通,再上正式模型。每把 key 都設額度上限,這個習慣遲早會救你一次。

常見問題

OpenRouter 會比直接用官方 API 貴嗎?

推論費率是原價轉售、不加價,成本差異只在儲值手續費(刷卡 5.5%、最低 0.8 美元,加密貨幣 5%)。一次儲多一點可以攤薄手續費。

OpenRouter 有免費模型嗎?

有,模型代號結尾帶 :free 的都免費,目前約 14 個。限制是每分鐘 20 次請求;累積儲值滿 10 美元後,每日上限從 50 次提高到 1,000 次。

我原本用 OpenAI SDK 寫的程式要改很多嗎?

幾乎不用改。OpenRouter 的 API 完全相容 OpenAI 格式,把 base_url 換成 https://openrouter.ai/api/v1、金鑰換成 OpenRouter 的 key 就能跑。

公司資料敏感,走 OpenRouter 安全嗎?

OpenRouter 預設只記錄 metadata、不記錄提示詞內容;可在請求中設 zdr:true 只路由到零資料保留端點,或用 data_collection:'deny' 排除會收集資料的供應商。