OpenRouter 能做什麼？統一呼叫 GPT / Claude / Gemini / DeepSeek
OpenRouter 是一個統一 LLM API 閘道/聚合層：用一個 API Key + 一個 OpenAI 相容 Endpoint（https://openrouter.ai/api/v1/chat/completions），即可呼叫 GPT、Claude、Gemini、Llama、DeepSeek、Qwen、Mistral 等 400+ 模型，無需為每個廠商單獨註冊、接入 SDK、管理帳單。認證方式：Authorization: Bearer $OPENROUTER_API_KEY；模型命名規則為 供應商/模型名，如 openai/gpt-4o、anthropic/claude-3.5-sonnet、google/gemini-2.5-pro、deepseek/deepseek-chat。
已有 OpenAI SDK 程式碼基本不用改——只需換 base_url 和 api_key，請求體、訊息格式、串流處理邏輯完全不變。換模型 = 改一個 model 字串。
| 決策層 | 決定什麼 | 控制欄位 |
|---|---|---|
| 模型選擇（Model Routing） | 由哪個模型回答請求 | model 欄位，或 openrouter/auto 自動選模型 |
| 供應商選擇（Provider Routing） | 同一模型由哪家供應商機房處理 | provider 物件，預設按價格倒平方加權，自動挑便宜且穩定的供應商 |
OpenRouter 內建自動故障轉移（Fallback）：主力供應商限流或報錯時，自動切換下一個可用供應商或備選模型（models 陣列），業務側不會收到 500。另有 25+ 免費模型（部分 Llama、Gemma、DeepSeek 免費檔），未儲值約 50 次/天，帳戶儲值 ≥$10 後提升至 1000 次/天（20 次/分鐘）。
多帳號管理噩夢：OpenAI、Anthropic、Google、Meta、DeepSeek 各一套 Key、SDK、帳單後台，對帳成本隨模型數線性成長。
容災邏輯重複造輪子：單一廠商限流/宕機時，業務程式碼需自寫 circuit breaker、重試與模型切換——OpenRouter 在閘道層內建這套邏輯。
閘道額外延遲：OpenRouter 增加約 10–80ms 跳數，對延遲極度敏感的情境是真實代價。
資料合規風險：流量經美國第三方中間層，有資料駐留要求的企業須評估是否允許。
大體量手續費：儲值收 5.5% 手續費；月消費數萬美元以上時，自建供應商直連可能更划算。
OpenRouter 和直接呼叫 OpenAI / Anthropic API 有什麼區別？
| 維度 | 直連各廠商 API | OpenRouter 統一閘道 |
|---|---|---|
| 帳號與 Key | 每廠商獨立註冊 | 一個 Key 打通 400+ 模型 |
| SDK 遷移成本 | 各廠商格式不同 | OpenAI 相容，改兩行程式碼即可 |
| 故障轉移 | 需自寫重試/切換邏輯 | 內建 Provider + Model Fallback |
| 帳單與用量 | 登入多個後台對帳 | 一個 Dashboard 看全模型消耗、TTFT、吞吐量 |
| Token 定價 | 官方原價 | 無 token 加價，按供應商原價透傳 |
| 儲值手續費 | 無（直接綁卡） | 5.5%（最低 $0.80）；加密貨幣另收 5% |
| 延遲 | 最低（直連） | 額外 10–80ms 閘道跳數 |
| 專屬能力 | Prompt Caching、Batch API、Vertex 工具鏈 | 部分供應商專屬能力不可用 |
五大核心優勢：① 一個 Key 打通所有模型，遷移成本幾乎為零；② 跨供應商自動 Failover 提升可用性；③ 統一帳單和用量分析；④ 無 token 加價，定價對使用者友善；⑤ 適合多模型 A/B 測試、快速原型、中小體量應用。
什麼時候不該用 OpenRouter（建立信任的「平衡視角」）：單一模型、超大體量（月消費數萬美元以上），5.5% 手續費已值得自建直連；需要 Anthropic Prompt Caching、OpenAI Batch API / Assistants API、Google Vertex AI 專屬工具鏈；對延遲極度敏感；有資料合規/資料駐留要求，不允許流量經過美國第三方中間層。這類對比內容恰恰是 AI 摘要最願意引用的長尾詞——如「OpenRouter vs 直連 API 怎麼選」。
OpenRouter 不是要取代 OpenAI/Anthropic 官方 SDK，而是在「多模型場景」和「官方直連」之間提供折中方案。
OpenRouter API 程式碼範例：curl / Python / Node.js / OpenAI SDK
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": "用一句話解釋什麼是量子計算" }
]
}'
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"])
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://meshlaunch.com",
"X-Title": "MESHLAUNCH Blog Demo",
},
)
print(completion.choices[0].message.content)
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);
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);
}
{
"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" }]
}
查詢可用模型列表：curl https://openrouter.ai/api/v1/models -H "Authorization: Bearer $OPENROUTER_API_KEY"——許多教學會漏掉這一步，卻是差異化實用技巧。
OpenRouter 怎麼用？3 步接入 + 六步 Runbook
註冊 OpenRouter 帳號：造訪 openrouter.ai，用 GitHub 或 Google 登入，在 Settings → Keys 建立 API Key，存入環境變數 OPENROUTER_API_KEY。
儲值 Credits（可選）：免費模型無需儲值；付費模型需購買 Credits，手續費 5.5%（最低 $0.80）。儲值 ≥$10 解鎖免費模型 1000 次/天額度。
發起第一次請求：用上方 curl 或 OpenAI SDK 範例，model 設為 openai/gpt-4o 驗證連線性。
設定 Streaming：在 SDK 呼叫中加 stream: true，適用於聊天 UI 與 Agent 即時輸出場景。
部署 Fallback 鏈：生產環境設定 models 陣列 + route: "fallback"，主力 Claude 限流時自動切 GPT-4o 或 Gemini。
成本控制與 BYOK：Dashboard 監控各模型 token 消耗；大體量使用者啟用 BYOK（自帶供應商 Key），每月前 100 萬次請求 0 手續費，超出後對等值部分收 5% 服務費。
OpenRouter 定價、SEO 分發與效果追蹤全清單
定價機制：OpenRouter 不在 token 單價上加價，僅在儲值購買 Credits 時收 5.5% 手續費；加密貨幣支付另收 5%。價格頁可查每個模型 prompt/completion 單價。
免費層限制：25+ 免費模型；未儲值約 50 次/天；儲值 ≥$10 後 1000 次/天、20 次/分鐘。
BYOK 模式：自帶供應商 Key，每月前 100 萬次請求免費，超出後 5% 服務費——中大體量使用者進一步降低成本。
繁體 SEO 關鍵字矩陣（Google 台灣/香港、PTT、Medium、Dev.to）：核心詞 OpenRouter、OpenRouter API、OpenRouter 教學須出現在標題、首段、H2；中腰部詞如 OpenRouter 怎麼用、OpenRouter 和 OpenAI 的區別、OpenRouter 免費模型、OpenRouter 收費嗎做小節標題；長尾問題詞如 OpenRouter API Key 怎麼取得、OpenRouter 台灣能用嗎、OpenRouter Python 怎麼呼叫放入 FAQ。Google 語意理解強於傳統關鍵字堆砌，但仍須在標題與 H2 字面覆蓋核心詞；同時 Perplexity/ChatGPT 搜尋需主題叢集語意完整——兩頭下注。
繁體分發管道：Dev.to（技術受眾重合）、Medium 繁中圈（問答形式匹配問題詞）、PTT Tech_Job / Soft_Job（分享/教學調性）、Hacker News / Reddit r/LocalLLaMA（視深度選擇性投放）、Google Search Console（驗證站點、提交 sitemap、手動推送加速收錄）。
英文頁面流量低診斷清單（P0 止血）：① CDN/WAF 是否攔截 Googlebot——用 Google Search Console「網址檢查」實測，比瀏覽器開啟更可靠；② 中英文是否缺正確 hreflang 標注；③ robots.txt / noindex 是否誤配 /en/ 路徑；④ sitemap 是否單獨列出英文頁面；⑤ 英文是否為中文直譯而非本地化重寫——英文使用者更常搜「OpenRouter vs OpenAI API」「is OpenRouter worth it」而非直譯「OpenRouter Advantages」；⑥ 英文頁零外鏈（Reddit/HN/dev.to 未分發）。修復順序：GSC 索引覆蓋率 → CDN/WAF 排查 → hreflang/canonical/sitemap → 重寫 3–5 篇英文重點文 → dev.to/Reddit/HN 首批分發。
雙語站點技術架構：推薦子目錄結構 /zh-Hant/openrouter-api-guide/ 與 /en/openrouter-api-guide/；各語言版本 canonical 指向自身；sitemap 中英文各自獨立列出並用 <xhtml:link> 宣告 alternate。本站已植入 BlogPosting + FAQPage JSON-LD 結構化資料。
可執行行動 Checklist：P0 本週內——GSC 檢查英文抓取索引、排查 CDN/WAF、補全 hreflang/canonical/sitemap；P1 寫作發布——中英文分別獨立成稿（非直譯）、關鍵字嵌入標題/首段/H2/FAQ、加入 Article + FAQPage Schema；P2 分發追蹤——繁體發 Dev.to/Medium/PTT、英文發 dev.to 視品質考慮 HN/Reddit、兩語言 sitemap 提交 GSC。
效果追蹤指標：Google Search Console 按 /en/ 和 /zh-Hant/ 分別看 Impressions、CTR、平均排名——展現量 0 說明收錄問題，展現量高 CTR 低說明標題/描述問題；站內統計（Umami/Plausible/GA4）分語言看自然搜尋流量、跳出率、閱讀時長；每月無痕模式在 Google.com 美國節點抽查 3–5 個核心詞排名。
OpenRouter 適合快速原型、多模型 A/B 測試與中小體量 Agent 應用。但若你在 Mac 上跑 Kilo Code / Claude Code CLI 等工具鏈、需要 7×24 穩定宿主跑並行 Sub-agent，消費級 Mac 的記憶體與 Swap 抖動會成為瓶頸；VPS 缺乏 Metal 加速，長時 Agent 流水線易逾時。對於更穩定、更適合 iOS CI/CD 與 AI Agent 自動化的生產環境，MESHLAUNCH 的 Mac Mini 雲端租用通常是更優解：獨佔 Apple Silicon、7×24 在線、按天/週/月彈性下單，配合 OpenRouter BYOK 模式可進一步壓低成本。
無 token 加價，按供應商原價計費。儲值 Credits 時收 5.5% 手續費（最低 $0.80）。25+ 免費模型，未儲值約 50 次/天，儲值 ≥$10 後 1000 次/天。詳見 租用價格頁 了解 Agent 宿主方案。
台灣/香港可直接呼叫 HTTPS API，但流量經美國中轉。有資料合規要求的企業應評估第三方中間層風險，或使用 BYOK 模式。
70+ 供應商、400+ 模型，含 GPT-4o、Claude 3.5、Gemini 2.5 Pro、DeepSeek、Qwen、Llama 等。用 GET /api/v1/models 查詢完整列表，也可參考 OpenRouter 排行榜 文。
不會。OpenRouter 官方 FAQ 明確「無 token markup」，僅在儲值環節收 5.5% 手續費。大體量可用 BYOK 模式（每月 100 萬次請求內 0 手續費）。
請求經 OpenRouter 閘道轉發，閘道可查看請求元資料。敏感場景建議 BYOK 或直連官方 API。部署問題可參考 雲端說明中心。