OPENROUTER
保姆級API
全模型接入.

OpenRouter API 保姆級教學 GPT Claude Gemini DeepSeek 全模型接入 2026

導語：如果你在問「OpenRouter 是什麼、怎麼用、和直連 OpenAI 有什麼區別？」——痛點：開發者要為 GPT、Claude、Gemini、DeepSeek 各註冊帳號、各寫一套 SDK，模型切換成本極高。結論：OpenRouter 是統一 LLM API 閘道，一組 Key + OpenAI 相容 Endpoint 即可呼叫 70+ 供應商、400+ 模型，已有 OpenAI SDK 程式只需改兩行。結構預告：路由機制表 → vs 直連對比 → 5 大優勢與「不該用」場景 → 3 步接入 → curl/Python/Node 全套程式碼 → 進階 Fallback/免費額度/成本控制 → 繁中 SEO 策略 → FAQ → Mac 開發收束。

30 秒讀懂 · TL;DR

定義統一 LLM API 閘道 · 70+ 供應商 / 400+ 模型 · OpenAI 相容
Endpointhttps://openrouter.ai/api/v1/chat/completions
定價無 token 加價 · 儲值收 5.5% 手續費 · BYOK 前 100 萬 次/月免費
免費模型25+ 免費模型 · 未儲值 50 次/天 · 儲值 ≥$10 後 1000 次/天
延遲代價閘道額外跳數約 10–80ms · 超大體量/合規場景建議直連

1. 痛點拆解：為什麼你需要一個「統一 API 閘道」

  1. 多廠商帳號碎片化。 OpenAI、Anthropic、Google、DeepSeek 各一套 Key、各一套 SDK、各一份帳單——Agent 框架要跑 A/B 測試，適配層程式碼量爆炸。
  2. 單點故障無容災。 Claude 限流時業務直接 429，自己寫 circuit breaker + 重試 + 模型切換，維運成本高於閘道內建 Fallback。
  3. 模型切換 = 重寫業務邏輯？ 直連時代換模型意味著換 SDK、換訊息格式、換串流處理；OpenRouter 換模型只需改 model 字串。
  4. 帳單對帳噩夢。 5 個後台、5 份 invoice、5 種計費單位——中小團隊更需要一個 Dashboard 看全量消耗。參考 6 月 OpenRouter 排行榜，DeepSeek 等模型占 61% 開發者 Token 份額，多模型路由已是常態。

2. OpenRouter 是什麼：統一 LLM API 閘道

OpenRouter 是一個「統一 LLM API 閘道 / 聚合層」：用一組 API Key + 一個 OpenAI 相容的 Endpoint，即可呼叫來自 70+ 家供應商、400+ 個模型（GPT、Claude、Gemini、Llama、DeepSeek、Qwen、Mistral 等），而不需要為每個廠商單獨註冊帳號、接入 SDK、管理帳單。

  • 統一 Endpoint： https://openrouter.ai/api/v1/chat/completions
  • 認證方式： Authorization: Bearer $OPENROUTER_API_KEY
  • 相容協議： OpenAI Chat Completions 格式，已有 OpenAI SDK 程式基本不用改，只需換 base_url 和 api_key
  • 模型命名規則： 供應商/模型名，例如 openai/gpt-4o、anthropic/claude-3.5-sonnet、google/gemini-2.5-pro、deepseek/deepseek-chat

2.1 路由機制：Model Routing vs Provider Routing

決策層決定什麼由什麼欄位控制
模型選擇（Model Routing）由哪個模型回答這次請求model 欄位，或使用 openrouter/auto 自動選模型
供應商選擇（Provider Routing）同一個模型由哪家供應商的機房來處理provider 物件，預設按價格倒平方加權，自動挑「便宜且穩定」的供應商
  • 自動故障轉移（Fallback）： 主力供應商限流/報錯時，OpenRouter 自動切換到下一個可用供應商或備選模型（models 陣列）。
  • 免費模型： 25+ 免費模型，未儲值約 50 次/天，儲值 ≥$10 後提升到 1000 次/天。
  • 價格機制： 不在 token 單價上加價；儲值收 5.5%（最低 $0.80） 手續費。BYOK 模式下每月前 100 萬次請求免費。

3. OpenRouter vs 直連各廠商 API：對比表

維度OpenRouter直連 OpenAI / Anthropic / Google
帳號管理一組 Key 呼叫 400+ 模型每個廠商單獨註冊、單獨 Key
SDK 遷移OpenAI SDK 改兩行即可各廠商 SDK/格式不同
故障轉移內建 Fallback + 供應商切換需自建重試/切換邏輯
帳單統一 Dashboard多後台分別對帳
Token 定價無 markup，原價透傳 + 5.5% 儲值費官方原價，無中間層手續費
延遲額外 10–80ms 閘道跳數直連，延遲最低
專屬能力通用 Chat CompletionsPrompt Caching、Batch API、Vertex 工具鏈等
合規流量經美國第三方閘道可選區域/企業合規方案

4. 5 大核心優勢 + 什麼時候不該用

4.1 優勢一：一組 Key 打通所有模型，遷移成本幾乎為零

不用為 OpenAI、Anthropic、Google、Meta、DeepSeek 各註冊一套帳號、Key、SDK。只需改兩行程式碼：base_url 和 api_key，其餘請求體、訊息格式、串流處理邏輯完全不變。

4.2 優勢二：跨供應商自動故障轉移，提升可用性

單一廠商限流/宕機是分散式系統常見故障點。OpenRouter 把「重試 + 切換供應商 + 切換模型」內建在閘道層。可顯式配置 fallback 鏈：models: ["anthropic/claude-3.5-sonnet", "openai/gpt-4o", "google/gemini-2.5-pro"]。

4.3 優勢三：統一帳單和用量分析

一個 Dashboard 看所有模型的消耗、成本、延遲（TTFT）、吞吐量，不用登入 5 個後台對帳。

4.4 優勢四：定價友好——無 token 加價

大部分聚合服務會在 token 單價上加價，OpenRouter 官方 FAQ 明確「無 token markup」，只在儲值環節收 5.5% 手續費。中大体量用戶可用 BYOK 模式進一步降本。

4.5 優勢五：快速原型與多模型 A/B

適合快速原型驗證、中小體量、需要多模型 fallback 提升可用性、同一套 Prompt/Agent 框架跑遍市面所有模型的場景。

4.6 什麼時候不該用 OpenRouter

  • 延遲極度敏感： 閘道增加約 10–80ms 額外跳數，即時對話/高頻交易不適用。
  • 超大體量： 月消費數萬美元以上，5.5% 手續費成本已值得自建供應商直連。
  • 資料合規/駐留： 不允許流量經過美國第三方中間層時，應直連或使用 BYOK。
  • 供應商專屬能力： Anthropic Prompt Caching、OpenAI Batch API、Google Vertex AI 專屬工具鏈——需直連官方。

5. 實戰教學：3 步接入 OpenRouter API

  1. 註冊帳號： 訪問 openrouter.ai，用 Google/GitHub 或信箱註冊。
  2. 取得 API Key： 進入 Keys 頁面 → Create Key → 複製 sk-or-v1- 開頭的密鑰，存入環境變數 OPENROUTER_API_KEY。
  3. 發起第一次請求： 用 curl 或 OpenAI SDK 向 https://openrouter.ai/api/v1/chat/completions 發送 POST，指定 model 和 messages，收到 JSON 回應即接入成功。

6. 程式碼範例：curl / Python / Node / 串流 / Fallback

6.1 cURL 直接請求

curl https://openrouter.ai/api/v1/chat/completions \ -H "Authorization: Bearer $OPENROUTER_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "anthropic/claude-3.5-sonnet", "messages": [ { "role": "user", "content": "用一句話解釋什麼是量子計算" } ] }'

6.2 Python（requests 原生寫法）

import requests import os response = requests.post( url="https://openrouter.ai/api/v1/chat/completions", headers={ "Authorization": f"Bearer {os.environ['OPENROUTER_API_KEY']}", "Content-Type": "application/json", }, json={ "model": "google/gemini-2.5-pro", "messages": [ {"role": "user", "content": "幫我寫一個快速排序的 Python 實作"} ], }, ) print(response.json()["choices"][0]["message"]["content"])

6.3 Python（OpenAI SDK 零成本遷移）

import os from openai import OpenAI client = OpenAI( base_url="https://openrouter.ai/api/v1", api_key=os.environ["OPENROUTER_API_KEY"], ) completion = client.chat.completions.create( model="openai/gpt-4o", messages=[{"role": "user", "content": "Hello!"}], extra_headers={ "HTTP-Referer": "https://macgpu.com", "X-Title": "MACGPU Blog Demo", }, ) print(completion.choices[0].message.content)

6.4 Node.js（OpenAI SDK 寫法）

import OpenAI from "openai"; const openai = new OpenAI({ baseURL: "https://openrouter.ai/api/v1", apiKey: process.env.OPENROUTER_API_KEY, }); const completion = await openai.chat.completions.create({ model: "deepseek/deepseek-chat", messages: [{ role: "user", content: "Explain OpenRouter in one sentence" }], }); console.log(completion.choices[0].message.content);

6.5 串流輸出（Streaming）

const stream = await openai.chat.completions.create({ model: "anthropic/claude-3.5-sonnet", messages: [{ role: "user", content: "寫一首關於秋天的短詩" }], stream: true, }); for await (const chunk of stream) { const content = chunk.choices[0]?.delta?.content; if (content) process.stdout.write(content); }

6.6 多模型 Fallback（容災）配置

{ "model": "anthropic/claude-3.5-sonnet", "models": [ "anthropic/claude-3.5-sonnet", "openai/gpt-4o", "google/gemini-2.5-pro" ], "route": "fallback", "messages": [{ "role": "user", "content": "Hello" }] }

6.7 查詢可用模型列表

curl https://openrouter.ai/api/v1/models \ -H "Authorization: Bearer $OPENROUTER_API_KEY"

7. 進階用法：Fallback 容災、免費模型、成本控制

7.1 Fallback 容災最佳實踐

  1. 主力模型選品質天花板（如 Claude 3.5 Sonnet），fallback 鏈放 GPT-4o 和 Gemini 2.5 Pro。
  2. 在 Cursor/Cline/OpenClaw 配置中寫入 models 陣列，避免單點 429 導致 Agent 中斷。
  3. 監控 Dashboard 中各模型的 TTFT 和錯誤率，定期按 OpenRouter 真實流量榜 刷新路由。

7.2 免費模型使用技巧

OpenRouter 提供 25+ 免費模型。未儲值約 50 次/天（20 次/分鐘）；儲值 ≥$10 後提升至 1000 次/天。適合原型驗證、Prompt 除錯、教學 Demo。

7.3 成本控制三板斧

  1. BYOK 模式： 已有官方 Key 時，每月前 100 萬 次請求經 OpenRouter 路由免費。
  2. 模型分層： 簡單任務走 DeepSeek V4 Flash 等低價模型，複雜推理才上 Claude Opus。
  3. 設定 Credits 上限： Dashboard 中設定月度預算告警，避免 Agent 無限循環燒額度。

8. 繁體中文 SEO 策略：關鍵詞矩陣與內容結構

8.1 關鍵詞矩陣

類型範例關鍵詞
核心詞OpenRouter、OpenRouter API、OpenRouter 教學
中腰部詞OpenRouter 怎麼用、OpenRouter API 接入、OpenRouter 和 OpenAI 的區別、OpenRouter 免費模型
長尾問題詞OpenRouter API Key 怎麼取得、OpenRouter 支援哪些模型、OpenRouter Python 怎麼呼叫
場景詞用 OpenRouter 搭建 AI 聊天機器人、OpenRouter 接入 Next.js、OpenRouter 多模型切換實戰

8.2 標題信號詞與 Meta 模板

繁中高 CTR 標題信號詞：完整指南、保姆級教學、從0到1、3步搞定、2026最新。Meta Description 控制在 150–160 字元，含核心詞 + 行動號召 + 信任型詞彙。

8.3 內容結構建議

  • 首段 150 字內直接給出 OpenRouter 定義（利於 AI 搜尋抓取）。
  • 每個 H2 對應一個明確搜尋意圖。
  • 文末 FAQ 5–8 條，加 FAQPage 結構化資料。
  • 使用繁體術語：頻寬、記憶體、伺服器（非簡體：带宽、内存、服务器）。

8.4 繁中分發渠道

PTT、Mobile01、Facebook 開發者社團、Medium 繁中版、Google Search Console 提交 sitemap。

9. 多語站點架構：URL / hreflang / canonical / sitemap

MACGPU 在 /frontend/{lang}/blog/ 下運行 8 語言目錄。每篇文章有本地化 slug，所有語言版本互相宣告 hreflang，x-default 指向英文，各頁 canonical 指向自身。

<link rel="alternate" hreflang="zh-Hant" href="https://macgpu.com/zh-Hant/blog/2026-0724-openrouter-baomu-api-jiaocheng-hant.html" /> <link rel="alternate" hreflang="en" href="https://macgpu.com/en/blog/2026-0724-openrouter-api-guide-gpt-claude-gemini.html" /> <link rel="alternate" hreflang="x-default" href="https://macgpu.com/en/blog/2026-0724-openrouter-api-guide-gpt-claude-gemini.html" />

10. 結構化資料（Schema）：BlogPosting + FAQPage

本文已在 <head> 注入 BlogPosting 和 FAQPage JSON-LD，承接 Google AI Overview / Featured Snippet。

11. 發布與分發渠道清單

渠道語言用途
PTT / Mobile01 / FB 社團繁中教程分發，快速獲取台港技術受眾
dev.to / HN英文技術教程天然受眾，帶 canonical 連結
X（Twitter）技術社群中英均可短線程摘要+連結

12. 可執行行動清單（P0 / P1 / P2）

  • P0： 發布 8 語言版本並補全 hreflang；驗證 BlogPosting + FAQPage JSON-LD
  • P1： 提交 GSC；從 3+ 篇 OpenRouter 相關文章加入內鏈
  • P2： 監控 GSC 展現量；A/B 測試 meta description CTR

13. 效果追蹤指標

  • Google Search Console： 按 /zh-Hant/ 分別看 Impressions、CTR、平均排名
  • 站內統計（Matomo）： 分語言版本的自然搜尋流量、跳出率、平均閱讀時長

14. 深度洞察：OpenRouter 時代的多模型架構分水嶺

2026 年 7 月，AI 開發者面臨的選擇已從「選哪個模型」變成「如何路由所有模型」。6 月 OpenRouter 排行榜顯示：DeepSeek 以 5.13T 週 Token 登頂，中國模型占 61% 開發者流量——開發者用帳單選擇「便宜、夠快、夠用」的模型。

對 MACGPU 讀者而言，OpenRouter 解決「API 層多模型路由」，Mac 解決「本地 Agent 壓測與工具鏈相容」。主機器走 OpenRouter 多模型 API，把 Agent 長會話壓測、MLX 本地推理驗證丟到遠端 Mac mini M4 節點——按需租用、SSH 隔離，避免佔滿本機記憶體與頻寬，遠端伺服器專職跑 Agent 壓測。

15. 常見問題 FAQ

Q：OpenRouter 收費嗎？怎麼計費？
A：不在 token 單價上加價，按供應商原價透傳。儲值收 5.5% 手續費（最低 $0.80）。BYOK 模式每月前 100 萬次請求免費。

Q：OpenRouter 台灣能用嗎？
A：可透過 HTTPS 直接呼叫。需注意網路延遲與合規；資料駐留要求高時評估直連或 BYOK。

Q：OpenRouter 支援哪些模型？
A：70+ 供應商、400+ 模型。用 GET /api/v1/models 查詢完整列表。

Q：OpenRouter API Key 怎麼取得？
A：註冊 openrouter.ai → Keys → Create Key → 複製 sk-or-v1- 密鑰，存入環境變數。

Q：OpenRouter Python 怎麼呼叫？
A：requests 直接 POST，或 OpenAI SDK 改 base_url + api_key 兩行即可。

Q：OpenRouter 和 Claude 直連哪個好？
A：多模型/fallback 場景 OpenRouter 更省心；單一 Claude 超大體量、Prompt Caching、合規場景直連更優。

Q：OpenRouter 免費模型怎麼用？
A：25+ 免費模型，未儲值 50 次/天，儲值 ≥$10 後 1000 次/天，20 次/分鐘。

Q：OpenRouter 安全嗎？資料會外洩嗎？
A：流量經美國第三方閘道轉發。官方不儲存 prompt 用於訓練，但高合規場景建議 BYOK 或直連。

16. 收束：OpenRouter 管 API 路由，Agent 壓測仍建議隔離到 Mac 節點

接入 OpenRouter、寫 curl/Python/Node 程式碼、配置 Fallback 鏈——Windows/Linux 都能做。但若你要在 Mac 上跑 Cursor + OpenRouter 多模型長會話編碼、OpenClaw/Hermes Agent 壓測，或本地 MLX 與 Cloud API 混合驗收，Apple Silicon 統一記憶體 + Metal 工具鏈仍是日常開發摩擦最小的路徑。

務實分工：主機器走 OpenRouter 多模型 API，把 Agent 壓測、長上下文批處理與量化驗證丟到 MACGPU 遠端 Mac mini M4 節點——按需租用、SSH 隔離，避免佔滿本機記憶體與頻寬。