OpenRouter 支援哪些模型？

覆蓋 70+ 供應商、400+ 模型，命名格式為供應商/模型名，如 openai/gpt-4o、anthropic/claude-3.5-sonnet。可透過 GET /api/v1/models 查詢完整清單。

OpenRouter 會在 token 單價上加價嗎？

不會。OpenRouter 官方 FAQ 明確無 token markup，僅在充值購買 Credits 時收取 5.5% 手續費。BYOK 模式下每月前 100 萬次請求免費。

OpenRouter 和 Claude 直連哪個好？

多模型對比、中小體量、需要 Fallback 容災時 OpenRouter 更省心；單一模型超大體量、需要 Anthropic Prompt Caching 或極低延遲時直連官方 API 更優。

OpenRouter 安全嗎？資料會洩漏嗎？

請求會路由至第三方供應商機房。有資料合規或資料駐留要求時，不應使用 OpenRouter 中間層，應直連官方 API 或自託管開源模型。

OpenRouter 保姆級教程：從0到1接入 GPT/Claude/Gemini 全模型（2026 最新完整指南）

Q: OpenRouter 收費嗎？

付費模型按供應商原價透傳 token 計費，充值 Credits 時收取 5.5% 手續費（最低 $0.80）。另有 25+ 免費模型，未充值約 50 次/天，充值 ≥$10 後提升至 1000 次/天。

Q: OpenRouter 國內能用嗎？

OpenRouter 為海外服務，國內存取取決於網路環境。建議在生產環境透過穩定出口或 Mac 雲節點發起 API 請求，避免本地網路波動導致 Agent 斷鏈。

Q: OpenRouter 支援哪些模型？

覆蓋 70+ 供應商、400+ 模型，命名格式為 供應商/模型名，如 openai/gpt-4o、anthropic/claude-3.5-sonnet。可透過 GET /api/v1/models 查詢完整清單。

如果你要為 Cursor、OpenClaw 或自研 Agent 同時接入 GPT、Claude、Gemini 卻不想維護五套 Key 和 SDK，本文以 OpenRouter 統一 LLM 閘道為核心，給出定義與路由原理、vs 直連 API 對比表、5 大優勢與「什麼時候不該用」、五步 Runbook、curl/Python/Node 全套程式碼、Fallback 容災、定價與 BYOK 說明，以及自建博客中英雙語 SEO 診斷策略與 FAQ。

1. 三個接入痛點：多廠商 Key 地獄

帳號與 Key 碎片化。 OpenAI、Anthropic、Google、Meta、DeepSeek 各需獨立註冊、帳單與 SDK 適配，換模型等於重寫適配層。
限流與宕機無內建容錯。 單一供應商 429/500 時，業務側需自行寫 circuit breaker、重試與模型降級邏輯。
帳單對帳成本高。 五個後台分別看 Token 消耗、延遲與費用，Agent 路由策略難以統一優化。

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

內部路由機制（技術亮點）

決策層	決定什麼	控制欄位
模型選擇（Model Routing）	由哪個模型回答請求	`model` 欄位，或 `openrouter/auto` 自動選模型
供應商選擇（Provider Routing）	同一模型由哪家機房處理	`provider` 物件，預設按價格倒平方加權挑「便宜且穩定」的供應商

主力供應商限流/報錯時，OpenRouter 自動切換到下一個可用供應商或備選模型（models 陣列），業務側不會收到 500。

3. OpenRouter 和直接調用 OpenAI / Anthropic API 有什麼區別

維度	OpenRouter	直連各廠商 API
Key 數量	1 個 Key 調用 400+ 模型	每廠商獨立 Key + SDK
遷移成本	改 base_url + api_key 即可	換廠商需重寫適配層
故障轉移	閘道內建 Fallback + 供應商切換	需自建重試/降級邏輯
帳單	統一 Dashboard 看全模型消耗	多後台分別對帳
Token 定價	無 markup，按供應商原價	官方原價（無中間層）
充值手續費	5.5%（最低 $0.80），加密另 5%	無（直接綁卡）
額外延遲	閘道增加約 10–80ms	最低延遲
專屬能力	不支援 Batch API、Prompt Caching 等廠商專屬功能	完整官方功能棧

4. OpenRouter 的 5 個核心優勢

一個 Key 打通所有模型，遷移成本幾乎為零。 換模型 = 改 model 字串，請求主體、串流邏輯完全不變。
跨供應商自動故障轉移（Failover）。 限流/宕機時閘道層內建重試 + 切換，無需業務側寫 circuit breaker。
統一帳單和用量分析。 一個 Dashboard 看所有模型消耗、成本、TTFT、吞吐量。
定價對使用者友好——無 token 加價。 只在充值環節收 5.5%；BYOK 模式每月前 100 萬次請求 0 手續費。
場景明確。 適合快速原型、A/B 測試多模型、中小體量（月消費幾千美元內）、多模型 Fallback 提升可用性。

5. 什麼時候不該用 OpenRouter（建立信任的平衡視角）

單一模型、超大體量（月消費數萬美元以上）——5.5% 充值手續費成本值得自建直連。
需要供應商專屬能力——Anthropic Prompt Caching、OpenAI Batch/Assistants API、Google Vertex AI 工具鏈。
對延遲極度敏感——閘道額外 10–80ms 跳數不可接受。
資料合規 / 資料駐留——不允許流量經過美國第三方中間層。

6. 實戰教程——五步接入 OpenRouter API

步驟 1 — 註冊 OpenRouter 帳戶

訪問 openrouter.ai 註冊。建議同時設定充值告警，避免 Agent 無限循環燒額度。

步驟 2 — 取得 API Key

Dashboard → Keys → Create Key。存入環境變數，禁止提交到 Git：

export OPENROUTER_API_KEY="sk-or-v1-..."

步驟 3 — 發起第一次請求（驗證連通）

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": "用一句話解釋什麼是量子計算"}]
  }'

步驟 4 — 切換到 OpenAI SDK（零成本遷移）

已有 OpenAI 程式碼只需改兩行：

from openai import OpenAI
import os

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://your-domain.com",
        "X-Title": "My Agent Demo",
    },
)
print(completion.choices[0].message.content)

步驟 5 — 配置 Fallback 並部署到 Mac 雲 7×24

生產 Agent 應配置 models 降級鏈，並將 Gateway 遷到 VPSMAC Mac 雲 launchd 常駐——見下文進階與結論。

7. 程式碼範例（curl / Python / Node.js / OpenAI SDK）

7.1 Python（requests 原生）

import requests, 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"])

7.2 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);

7.3 串流輸出（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);
}

7.4 查詢可用模型清單

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

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

8.1 多模型 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"}]
}

主模型被限流或報錯時，OpenRouter 按順序自動嘗試下一個，業務側無需額外重試邏輯。

8.2 免費模型與額度

OpenRouter 提供 25+ 免費模型（部分 Llama、Gemma、DeepSeek 免費檔）。未充值約 50 次/天；帳戶充值 ≥$10 後提升至 1000 次/天、20 次/分鐘。適合原型驗證，生產敏感資料請用付費 API。

8.3 定價機制

無 token markup——按供應商原價透傳。
充值 Credits 收 5.5% 手續費（最低 $0.80），加密貨幣另收 5%。
BYOK（自帶供應商 Key）：每月前 100 萬次請求免費，超出後對等值部分收 5% 服務費。

9. 可引用技術要點

70+ 供應商、400+ 模型——一個 Endpoint 覆蓋 GPT-4o、Claude 3.5、Gemini 2.5、DeepSeek、Llama 等。
閘道額外延遲約 10–80ms——對比直連需在 SLA 預算內評估。
25+ 免費模型——未充值 50 次/天，充值 ≥$10 後 1000 次/天。
充值手續費 5.5%（最低 $0.80）——月消費數萬美元以上值得評估直連 ROI。
BYOK 每月 100 萬次免費——中大體量使用者可顯著降低中間層成本。

10. 雙語 SEO 策略與英文頁面流量診斷

若你在 VPSMAC 這類自建雙語博客發布 OpenRouter 教程，中英文頁面流量差異通常來自以下疊加因素——建議按優先順序自查：

10.1 抓取與索引層（P0，最常被忽視）

CDN/WAF 攔截 Googlebot——用 Google Search Console「網址檢查」實測抓取，比瀏覽器打開更可靠。
robots.txt / noindex 誤配置——確認未 disallow /en/ 路徑。
sitemap 未單獨列出各語言頁面——中英文應各自獨立 <url> 條目。
CSR 空殼——純前端渲染頁面爬蟲可能拿到空 HTML，導致長期不收錄。

10.2 內容層

英文勿直譯中文——英文使用者更常搜 "OpenRouter vs OpenAI API"、"is OpenRouter worth it"，而非 "OpenRouter Advantages"。
首段 150 字內給出明確定義——利於百度摘要與 Google AI Overview 抓取。
FAQ 承接長尾問題詞——如「OpenRouter 收費嗎」「OpenRouter 國內能用嗎」「OpenRouter Python 怎麼調用」。

10.3 中文關鍵字矩陣（標題/H2/FAQ 覆蓋）

核心詞：OpenRouter、OpenRouter API、OpenRouter 教程。中腰部：OpenRouter 怎麼用、和 OpenAI 的區別、免費模型、收費嗎。長尾：API Key 怎麼取得、支援哪些模型、和 Claude 直連哪個好、安全嗎。

10.4 英文關鍵字矩陣（本地化重寫，非直譯）

核心：OpenRouter API, OpenRouter tutorial。對比類高轉化：OpenRouter vs OpenAI API, is OpenRouter worth it。How-to：OpenRouter Python example, OpenRouter fallback routing, OpenRouter streaming response。

10.5 發布與分發渠道

渠道	語言	用途
掘金 / V2EX / 知乎 / CSDN	中文	教程分發，快速取得國內技術受眾
dev.to	英文	技術教程受眾重合，可帶 canonical 回鏈
Hacker News / Reddit	英文	精準垂直受眾，取得初始外鏈
百度搜索資源平台 / GSC	中英	提交 sitemap，分路徑看 Impressions

10.6 效果追蹤指標

GSC 按 /en/ 與 /zh/ 分別看 Impressions——展現量為 0 是收錄問題，展現高 CTR 低是標題/描述問題。每月無痕搜尋 3–5 個核心詞確認排名。

11. 常見問題 FAQ

OpenRouter 收費嗎？ 付費模型按 token 原價計費；充值收 5.5%。25+ 免費模型有日限額。

OpenRouter 國內能用嗎？ 取決於網路出口穩定性；生產 Agent 建議 Mac 雲節點發起請求。

支援哪些模型？ 400+ 模型，格式 供應商/模型名，用 /api/v1/models 查詢。

OpenRouter 安全嗎？ 流量經第三方路由；有合規要求請直連或自託管。

和 OpenAI SDK 相容嗎？ 完全相容，改 base_url 和 api_key 即可。

英文頁面為什麼沒流量？ 先查 GSC 索引，再查是否機翻、關鍵字是否對齊英文搜尋習慣。

12. 結論與選型建議

在筆電或 Windows/Linux 普通 VPS 上跑 OpenRouter Agent，常見問題是：本地合蓋斷鏈、純 Linux 缺 Apple 工具鏈、網路波動導致 Gateway 與 API 同時逾時。OpenRouter 解決了「多模型統一接入」，但執行環境仍決定 Agent 能否 7×24 穩定——Docker 方案雖靈活，卻有額外抽象層、排障複雜度與性能折損。

2026 最佳實務：OpenRouter 選模型 + 自持 API Key + VPSMAC Mac 雲跑 OpenClaw Gateway——模型切換只改 Route，執行時在原生 macOS + launchd 上守。若你剛完成 OpenRouter 接入驗證，下一步應在 Mac 雲完成 launchd 驗收與 Fallback 探針，別讓 Gateway 跟著本地機器一起休眠。