OpenRouter 支援哪些模型？

涵蓋 70+ 供應商、400+ 模型，包括 GPT-4o、Claude 3.5 Sonnet、Gemini 2.5 Pro、DeepSeek、Llama、Qwen 等。可透過 GET /api/v1/models 查詢完整列表與即時定價。

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

請求經 OpenRouter 閘道路由至底層供應商；對資料合規要求嚴格的場景（如資料駐留）應評估是否直連官方 API。BYOK 模式可自帶供應商 Key，減少中間層暴露。

OpenRouter 和 Claude 直連哪個好？

多模型對比、快速原型、中小體量應用更適合 OpenRouter；單一模型超大體量、需要 Anthropic Prompt Caching 等專屬能力、或對延遲極度敏感時應考慮直連官方 API。

OpenRouter 會在 token 單價上加價嗎？

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

OpenRouter API 保姆級教程 2026

Q: OpenRouter 要收費嗎？

OpenRouter 提供 25+ 免費模型（帶日請求限制）；付費模型按供應商原價透傳 token 單價，儲值 Credits 時收取 5.5% 手續費（最低 $0.80）。帳戶儲值 ≥$10 後免費模型限額提升至約 1000 次/天。

Q: OpenRouter 在中國能用嗎？

OpenRouter 為海外服務，境內存取取決於網路環境。建議在遠端 Mac 或穩定出口環境下測試 API 連通性與延遲，OpenClaw、Claude Code 等 CLI Agent 可在 VNC 遠端 Mac 上圖形化驗收。

01

OpenRouter 能做什麼——統一呼叫 GPT / Claude / Gemini / DeepSeek

OpenRouter 不是要取代 OpenAI/Anthropic 官方 SDK，而是在「多模型場景」與「官方直連」之間提供折衷：已有 OpenAI SDK 程式碼基本不用改，只需換 base_url 和 api_key；換模型 = 改一個 model 字串，例如 openai/gpt-4o、anthropic/claude-3.5-sonnet、google/gemini-2.5-pro、deepseek/deepseek-chat。

內部路由分兩層決策，寫文章與排障時值得記清：

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

自動故障轉移（Fallback）：主力供應商限流/報錯時，OpenRouter 自動切換下一個可用供應商或備選模型（models 陣列），業務側不必自己寫 circuit breaker。
免費模型：25+ 免費模型（部分 Llama、Gemma、DeepSeek 免費檔），未儲值約 50 次/天；帳戶儲值 ≥$10 後約 1000 次/天、20 次/分鐘。
價格機制：無 token 單價加價，按供應商原價透傳；儲值 Credits 時收 5.5%（最低 $0.80），加密貨幣另收 5%。BYOK 自帶 Key：每月前 100 萬次請求免費，超出對等值部分收 5% 服務費。

02

痛點拆解：多廠商 API 的隱性成本

在決定用 OpenRouter 還是直連之前，先對齊「不用閘道」時常見五條痛點：

01
帳號與 Key 碎片化：OpenAI、Anthropic、Google、Meta、DeepSeek 各一套註冊、帳單、SDK 版本，Agent 框架要維護多套適配層。
02
故障轉移要自己寫：單一廠商限流/宕機時，重試 + 切換供應商 + 切換模型的邏輯落在業務程式碼，維運成本高。
03
對帳分散：五個後台對 token 消耗、延遲（TTFT）、吞吐量，難以做統一成本分析。
04
聚合層加價：部分同類服務在 token 單價上加價；OpenRouter 官方 FAQ 明確「無 token markup」，只在儲值環節收 5.5%。
05
閘道額外跳數：OpenRouter 會增加約 10–80ms 延遲；對延遲極度敏感或資料合規/駐留要求嚴格的場景，直連更合適。

03

OpenRouter vs 直連 OpenAI / Anthropic / Google API

維度	OpenRouter	直連官方 API
接入成本	改 base_url + 一個 Key	每廠商獨立 Key、SDK、帳單
多模型切換	改 model 字串即可	重寫適配層或換 SDK
故障轉移	閘道內建 Fallback	業務側自實作
Token 定價	供應商原價透傳 + 儲值 5.5% 費	官方標價；大體量可談 enterprise
專屬能力	部分廠商專屬 API（Batch、Prompt Caching 等）可能不可用	完整官方功能棧
延遲	多約 10–80ms 閘道跳數	通常更低
資料合規	流量經美國第三方閘道	可選 Vertex、區域 endpoint 等

五個核心優勢

一個 Key 打通所有模型，遷移成本幾乎為零。
跨供應商自動 Failover，可明確設定 models fallback 鏈。
統一 Dashboard 看消耗、成本、延遲與吞吐量。
無 token 加價，中大體量可用 BYOK 進一步降本。
場景明確：原型驗證、A/B 測模型、多模型 Agent、月消費幾千美元以內應用。

⚠

什麼時候不該用 OpenRouter（建立信任的關鍵段落）：單一模型、月消費數萬美元以上時 5.5% 儲值費值得自建直連；需要 Anthropic Prompt Caching、OpenAI Batch/Assistants、Vertex 專屬工具鏈；對延遲極度敏感；或有資料駐留要求不允許流量經美國中間層。這類「勸退」內容利於 E-E-A-T，也承接「OpenRouter vs 直連 API」長尾搜尋。

04

實戰：5 步接入 OpenRouter API

01
註冊：造訪 openrouter.ai 建立帳戶。
02
取得 Key：在 Keys 頁面建立 API Key，存入環境變數 OPENROUTER_API_KEY，勿提交到 Git。
03
儲值（可選）：免費模型可先試；付費模型在 Credits 頁儲值，注意 5.5% 手續費。
04
查模型列表：curl https://openrouter.ai/api/v1/models -H "Authorization: Bearer $OPENROUTER_API_KEY"
05
發起第一次請求：見下一節程式碼；建議攜帶 HTTP-Referer 與 X-Title 便於 OpenRouter 排行榜統計。

05

程式碼範例：curl / Python / Node.js / OpenAI SDK

bash

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

python

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

javascript

import OpenAI from "openai";

const openai = new OpenAI({
  baseURL: "https://openrouter.ai/api/v1",
  apiKey: process.env.OPENROUTER_API_KEY,
});

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

多模型 Fallback 容災設定（體現優勢二的落地程式碼）：

json

{
  "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"}]
}

06

進階：Fallback、免費模型與成本控制

用 models 陣列 + route: "fallback" 設定主力→備選鏈，Claude 限流時自動試 GPT/Gemini。
免費檔適合開發除錯；生產環境關注 Dashboard 中各模型 prompt/completion 單價。
月請求量大時評估 BYOK：自帶 OpenAI/Anthropic Key，前 100 萬次/月免 OpenRouter 服務費。
OpenClaw 使用者可結合多模型路由與成本優化做降級策略。

可引用數字（便於摘要抓取）：

70+ 供應商、400+ 模型；25+ 免費模型。
儲值手續費 5.5%（最低 $0.80）；無 inference token markup。
閘道額外延遲約 10–80ms；BYOK 每月前 100 萬次請求免費。

07

自建部落格：為什麼英文頁面流量低？診斷清單

若你在 VNCMac 或自建站同時發中英版本，英文曝光為 0 往往是抓取/索引問題而非內容品質。按優先級自查：

層級	檢查項
抓取與索引	CDN/WAF 是否攔截 Googlebot；hreflang 是否正確；robots.txt 是否誤 disallow /en/；sitemap 是否分語言列出；是否 CSR 空殼 HTML
內容層	英文是否為「機翻」而非本地化重寫；關鍵字是否對齊英文搜尋習慣（如 "OpenRouter vs OpenAI API"）；E-E-A-T 是否不足
外鏈層	中文在掘金/知乎有分發，英文是否在 dev.to、Reddit、Hacker News 有初始外鏈

修復順序（性價比從高到低）：① Google Search Console 網址檢查；② 排查 CDN/WAF；③ 補齊 hreflang、canonical、sitemap；④ 重寫 3–5 篇重點英文文（非直譯）；⑤ dev.to / Reddit 首批分發。

08

繁體中文 SEO 策略要點

核心詞：OpenRouter、OpenRouter API、OpenRouter 教程須在標題、首段、H2 原樣出現。中腰部詞做小節標題：OpenRouter 怎麼用、OpenRouter 和 OpenAI 的區別、OpenRouter 免費模型、OpenRouter 要收費嗎。FAQ 承接長尾：OpenRouter API Key 怎麼取得、OpenRouter 在中國能用嗎、OpenRouter Python 怎麼呼叫。

標題訊號詞組合：「保姆級教程 + 從 0 到 1 + 2026 最新」提升 CTR。Meta Description 控制在 70–110 字，含核心詞 + 行動號召 + 信任詞（真實踩坑/程式碼範例）。分發：PTT、Facebook 社團、V2EX、Google Search Console 提交 sitemap；簡體版可同步掘金、知乎。

09

英文 SEO 與雙語站點架構

英文核心詞：OpenRouter API, OpenRouter tutorial, how to use OpenRouter；高轉化對比詞：OpenRouter vs OpenAI API, is OpenRouter worth it。英文標題勿堆砌形容詞，用 1 個 Complete Guide / Step-by-Step + 技術元素（2026、Python & Node.js）。

不要逐句翻譯中文稿——至少重寫標題、首段 TL;DR、H2、FAQ 問句。推薦 URL 結構：

url

https://yourblog.com/zh-Hant/openrouter-api-guide/
https://yourblog.com/en/openrouter-api-guide/

hreflang 範例（各語言頁 <head>）：

html

<link rel="alternate" hreflang="zh-Hant" href="https://yourblog.com/zh-Hant/openrouter-api-guide/" />
<link rel="alternate" hreflang="zh-Hans" href="https://yourblog.com/zh/openrouter-api-guide/" />
<link rel="alternate" hreflang="en" href="https://yourblog.com/en/openrouter-api-guide/" />
<link rel="alternate" hreflang="x-default" href="https://yourblog.com/en/openrouter-api-guide/" />
<link rel="canonical" href="https://yourblog.com/zh-Hant/openrouter-api-guide/" />

結構化資料：至少 TechArticle/Article + FAQPage JSON-LD（本文 head 已嵌入範例）。英文 FAQ 問句用口語：Is OpenRouter free? 而非 Free usage of OpenRouter。

10

發布分發與可執行行動清單

優先級	行動
P0	GSC 檢查英文抓取；排查 CDN/WAF；補 hreflang + canonical + sitemap
P1	中英分別撰寫/本地化；嵌入 Article + FAQPage Schema
P2	繁中→PTT/V2EX/社團；簡中→掘金/知乎；英文→dev.to、視品質 HN/Reddit；雙語 sitemap 提交 GSC

效果追蹤：GSC 按 /en/ 與 /zh-Hant/ 分別看 Impressions/CTR/排名——曝光量為 0 = 收錄問題，曝光高 CTR 低 = 標題/描述問題。站內統計分語言看自然搜尋、跳出率、閱讀時長。

FAQ

常見問題

25+ 免費模型帶日限；付費模型按供應商原價計費，儲值時收 5.5% 手續費。儲值 ≥$10 後免費模型限額約 1000 次/天。

取決於網路出口。建議在穩定環境下測試；在遠端 Mac上跑 OpenClaw/CLI Agent 時，可用 VNC 圖形工作階段驗收 API 連通與日誌。

不會。僅在儲值 Credits 時收 5.5%；BYOK 每月前 100 萬次請求免服務費。

多模型、原型、中小體量 → OpenRouter；超大體量、Prompt Caching、極致延遲或合規 → 直連。見第三節對比表。

只改 base_url="https://openrouter.ai/api/v1" 與 api_key，其餘請求體、串流邏輯不變。見第五節 Python 範例。

結語

OpenRouter 把「多模型接入」從五套帳號收成一把 Key + 兩行設定，Fallback 與統一帳單則把 Agent 維運從業務層挪到閘道層。但若你同時在 Mac 上跑 OpenClaw、Claude Code 或 Kimi Code，本地或 SSH-only 環境常卡在OAuth 回呼、系統權限彈窗與 Gateway 圖形驗收——純終端機很難對照瀏覽器 Network 與 macOS 隱私面板。

自購 Mac 還要承擔睡眠策略、系統更新與硬體折舊；Windows 主力機則缺少原生 macOS Agent 生態。相較之下，租用 VNCMac 遠端 Mac + VNC 圖形工作階段可在與 Gateway 同機環境下完成多模型路由驗收，把 OpenRouter 接進生產 Agent 的隱性排障成本壓到可預期區間。

若你希望少押一台自有硬體、又要在 OpenClaw 控制台裡對照 OpenRouter 模型切換與 Token 消耗，可直接透過 VNCMac 開通雲端 Mac：下方主按鈕進入購買頁；需要對比套餐時先瀏覽首頁。

OpenRouter 保姆級教程從 0 到 1 接入 GPT / Claude / Gemini