OpenRouter 會在模型定價上加價嗎？

不會。OpenRouter 按上游供應商公布的 token 單價計費。平台收入來自儲值手續費（5.5%）或 BYOK 模式下每月超過 100 萬次請求後的 5% 路由費。

OpenRouter 值得用嗎？還是直連 OpenAI 比較好？

若你需要同時試用 GPT、Claude、Gemini、內建容錯路由與統一帳單，月支出在約 1 萬美元以內，OpenRouter 通常更划算。若你是單一模型超大流量、需要 OpenAI Batch API 或嚴格資料落地合規，直連供應商 API 往往更合適。

現有的 OpenAI Python SDK 能直接接 OpenRouter 嗎？

可以。將 base_url 設為 https://openrouter.ai/api/v1，api_key 換成 OpenRouter 金鑰，並把 model 改為 provider/model 格式（例如 openai/gpt-4o、anthropic/claude-3.5-sonnet）即可。

OpenRouter 容錯路由怎麼運作？

在請求中提供 models 陣列並設定 route 為 fallback。當主要模型被限流或回傳 5xx 時，OpenRouter 依序嘗試後備模型，無需在客戶端撰寫重試邏輯。

OpenRouter 支援哪些模型？

OpenRouter 聚合 70 多家供應商的 400 多款模型，涵蓋 GPT、Claude、Gemini、Llama、DeepSeek、Qwen、Mistral 等。可呼叫 GET /api/v1/models 取得即時目錄與各模型定價。

OpenRouter 支援串流回應嗎？

支援。在 chat completions 請求中設定 stream: true，行為與 OpenAI API 相同，回傳 SSE 格式的 delta chunk，現有串流解析器可直接沿用。

生產環境把 API 金鑰放在 OpenRouter 安全嗎？

OpenRouter 已被大量 Agent 與 IDE 工具用於生產，但金鑰仍應按環境分離、定期輪替，並避免寫入共用 shell 設定檔。若合規要求流量不經第三方閘道，可評估 BYOK 模式或直連供應商。

OpenRouter API 保姆級教程：GPT、Claude、Gemini 一鍵接入（2026）- MacDate

Q: OpenRouter 要收費嗎？

OpenRouter 提供 25 款以上免費模型，未儲值時約每日 50 次請求；儲值 10 美元後免費模型配額約升至每日 1,000 次。GPT、Claude、Gemini 等旗艦模型按上游 token 原價計費，平台不在 token 上加價，僅在儲值時收取 5.5% 手續費（最低 0.80 美元）。

精選摘要

OpenRouter 是統一 LLM API 閘道：一把 OpenRouter API 金鑰 搭配 OpenAI 相容端點（https://openrouter.ai/api/v1/chat/completions），即可呼叫 400+ 模型——只需修改 model 字串（如 openai/gpt-4o、anthropic/claude-3.5-sonnet、google/gemini-2.5-pro）。現有 OpenAI SDK 程式碼只需替換 base_url 與 api_key；平台提供自動供應商路由、可選多模型容錯，且 token 不加價（儲值時收取 5.5% 手續費）。

01 · 什麼是 OpenRouter？

單一端點、全部模型： Authorization: Bearer $OPENROUTER_API_KEY 加上 provider/model 格式的模型 ID。
雙層路由： model 欄位選模型；provider 物件可指定供應商偏好（預設按價格加權）。
內建容錯： 上游限流或 5xx 時，可透過 models 陣列自動切換後備模型。
定價透明： token 單價與上游一致；平台收入來自儲值手續費（5.5%，最低 0.80 美元）或 BYOK 超量費（每月前 100 萬次請求免費，之後 5%）。
免費額度： 25+ 免費模型；未儲值約 50 次／日，儲值 10 美元後約 1,000 次／日，免費模型限速 20 次／分鐘。

硬核數據 #1： OpenRouter 公開排行榜顯示，滾動七日内常有 28+ 兆 token 流量——代表決策依據是生產 Agent，而非玩具腳本。詳見我們的帳單真相分析。

02 · 三大決策陷阱

把 OpenRouter 當「免費 GPT」： 免費模型存在，但旗艦 GPT／Claude／Gemini 仍消耗付費額度。未設定預算告警的團隊，常在財務追問帳單時才發現 5.5% 儲值手續費。
忽略延遲成本： 每個請求多經一層閘道，典型增加 10–80 ms（視區域而定）。語音即時或低延遲交易場景應先實測，再決定是否上線。
在主力 MacBook 上做 A/B 測試： Cursor、OpenClaw 與自訂 Agent 會把金鑰寫進 shell 設定、污染本機快取，並混用正式與實驗憑證。隔離硬體比「用完再刪環境變數」可靠得多。

03 · OpenRouter vs 直連 API（OpenAI、Anthropic、Google）

高意圖搜尋詞是「OpenRouter 跟 OpenAI API 差在哪」——以下表格按決策維度整理，方便直接引用。

維度	OpenRouter API	直連 OpenAI／Anthropic／Google
API 金鑰	一把金鑰存取 400+ 模型	各供應商獨立帳號、金鑰與帳單
SDK 遷移	OpenAI 相容，替換 `base_url` 即可	各家用原生 SDK 或自建適配層
Token 定價	不加價，按上游牌價	上游牌價
平台費用	儲值 5.5%（最低 0.80 美元）；加密貨幣另加 5%	無額外閘道費
容錯	內建供應商＋模型 fallback	需自行實作重試與熔斷
儀表板	統一用量、成本、延遲（TTFT）	各供應商後台分散
獨家功能	子集（無 OpenAI Assistants／Batch 一級支援）	完整 vendor 功能（prompt cache、Vertex 工具等）
延遲	典型多 10–80 ms 閘道跳轉	直連供應商區域
合規	流量經美國閘道；可選 BYOK	各 vendor 資料落地與企業合約
最適場景	多模型產品、原型驗證、月支出 <~1 萬美元	單模型超大流量、嚴格合規、毫秒級 SLA

硬核數據 #2： 以每月 100 萬 token 的 Claude Sonnet workload 估算，OpenRouter 儲值手續費約 4–8 美元——往往低於維護三套整合的工程成本；但月支出超過 5 萬美元 時，BYOK 或直簽合約更值得試算。

04 · 五大優勢——以及何時不該用 OpenRouter

優勢 1：一把金鑰解鎖所有模型

不必分別註冊五家供應商。把 model 從 openai/gpt-4o 改成 anthropic/claude-3.5-sonnet，訊息格式與串流解析器無需改動。

優勢 2：自動容錯

上游限流是常態。OpenRouter 的供應商路由與 models fallback 鏈可移除自訂熔斷程式——見第 08 節。

優勢 3：統一帳單與分析

一個儀表板追蹤 token 支出、延遲與模型 mix——當 Kilo Code、OpenClaw 等 CLI 已占 OpenRouter 流量 70%+ 時尤其重要（參考 Agent 選型報告）。

優勢 4：Token 不加價

與許多聚合商不同，OpenRouter 官方 FAQ 明確表示按上游牌價 pass-through；平台費只發生在儲值或 BYOK 超量。

優勢 5：免費模型做原型

25+ 免費模型（Llama、Gemma、DeepSeek 免費檔等）適合 hackathon 與 CI 冒煙測試，再升級到付費旗艦。

不適用 OpenRouter 的四種情境

單一模型超大流量： 5.5% 儲值費可能高於談好的企業直連合約。
需要 vendor 獨家 API： OpenAI Batch／Assistants、Anthropic prompt cache 計費優化、Google Vertex 專屬工具。
嚴格資料落地： 禁止流量經美國第三方閘道（除非 BYOK 通過法務審查）。
次 50 ms 推理 SLA： 多一層跳轉可能破壞產品需求。

誠實寫出「何時不用」能建立 E-E-A-T，也更容易命中「OpenRouter 值得嗎」這類高轉換搜尋意圖。

05 · 金鑰三步設定（含延伸檢查）

註冊並建立金鑰： 前往 openrouter.ai 以 GitHub 或 Google 登入，在 Keys 面板建立金鑰（命名如 dev-mac-sandbox，勿在筆電上用 production）。
設定環境變數與額度： export OPENROUTER_API_KEY="sk-or-..."（勿提交 git）；在後台為金鑰設定 credit limit，避免團隊共用帳單失控。
用 curl 驗證再接入 IDE： 以下一節範例對 GPT、Claude、Gemini 各打一槍，確認 200 回應後再接入 Cursor、LangChain 或 OpenClaw。

延伸步驟（建議）： 儲值 10 美元解鎖較高免費模型配額；在 Settings 貼上上游 OpenAI／Anthropic 金鑰啟用 BYOK（每月前 100 萬次路由免費）；部署前呼叫 Models API 確認 model slug。

06 · 程式碼範例：curl、Python、OpenAI SDK、Node.js

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 os
import requests

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 from OpenRouter!"}],
    extra_headers={
        "HTTP-Referer": "https://macdate.com",
        "X-Title": "MacDate OpenRouter 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: "用一句話說明 OpenRouter。" }],
});

console.log(completion.choices[0].message.content);

硬核數據 #3： 模型 ID 必須用 provider/model 格式——即時目錄有 400+ 筆。硬編碼 gpt-4o 而不加 openai/ 前綴會 404；部署後務必從 Models API 拉最新 slug。

07 · 串流回應

與 OpenAI 相同，設定 stream: true 即可。以下為 Node.js 範例；Python 的 stream=True 行為一致。

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

08 · 容錯路由 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" }]
}

Claude 被限流或 5xx 時，OpenRouter 依序嘗試 GPT-4o、Gemini 2.5 Pro——客戶端無需自寫重試迴圈。

09 · Models API（即時目錄）

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

回應含各模型 pricing.prompt 與 pricing.completion，可用來建成本估算器，對齊儀表板帳單。

10 · 定價：Token 不加價、5.5% 儲值費、BYOK、免費額度

費用類型	費率	備註
付費模型 token	上游牌價	OpenRouter 不在 token 上加價
儲值	5.5%（最低 0.80 美元）	充值餘額時收取
加密貨幣付款	另加 5%	疊加在儲值手續費之上
BYOK 路由	每月前 100 萬次免費	超量後按等效用量收 5%
免費模型	token 0 元	預設 ~50 次／日；儲值 10 美元後 ~1,000 次／日
免費模型限速	20 次／分鐘	僅適用免費端點

11 · 五步驗證清單

在隔離機器（非主力 MacBook）匯出 disposable OPENROUTER_API_KEY，用 curl 對 GPT、Claude、Gemini 各打一槍。
把 OpenAI SDK 的 base_url 改為 https://openrouter.ai/api/v1，確認回應 schema 一致。
啟用 stream: true，量測 TTFT 與直連 baseline 對比。
POST fallback JSON；先用無效 model 觸發失敗，確認鏈路成功。
匯出延遲、token 與成本 CSV；撤銷測試金鑰並清除環境。

12 · 常見問題

Q：OpenRouter 要收費嗎？
A：部分免費。25+ 免費模型有每日配額；旗艦模型按上游 token 計費。

Q：會在模型價格上加價嗎？
A：token 不加價。平台費來自 5.5% 儲值手續費或 BYOK 超量 5%。

Q：比直連 OpenAI 值得嗎？
A：多模型產品、原型與內建容錯通常值得；單模型超大流量或嚴格合規往往直連更好——見第 03 節表格。

Q：現有 OpenAI Python 程式能直接用嗎？
A：可以。改 base_url、金鑰與 provider/model 格式即可。

Q：容錯路由怎麼設定？
A：提供 models 陣列並設 "route": "fallback"。

Q：支援哪些模型？
A：400+ 模型、70+ 供應商。呼叫 GET /api/v1/models 取得即時目錄。

Q：生產環境安全嗎？
A：廣泛用於生產，但金鑰應分環境、定期輪替，並避免在共用 shell 設定檔長期存放。

Q：支援串流嗎？
A：支援。stream: true 即可，SSE delta 與 OpenAI 相容。

13 · 租賃隔離 Mac 做 OpenRouter 多模型測試

任何 Linux VPS 都能跑 curl，但團隊真正要驗證的往往是 Cursor BYOK 路由、OpenClaw 閘道、macOS Keychain 隔離與 IDE Agent 並行——這些在 Apple Silicon 乾淨使用者帳號上的行為，與 Windows 雲主機或通用 Linux shell 不同。在主力 MacBook 上做 GPT／Claude／Gemini A/B 測試，金鑰會漏進 .zshrc、快取目錄混用，切回正式模型時 fallback 設定仍留在本機。

為三天路由 sprint 買 Mac mini 固定成本高；按日計費租賃 符合「建金鑰 → 實測 → 撤銷 → 銷毀節點」節奏。雖然瀏覽器聊天介面適合隨手問答，卻無法可靠驗證串流解析器、容錯鏈與 per-model 成本 log——這些都需要隔離的 macOS Agent 執行環境。租賃實體 Mac 能讓實驗金鑰不進主力 Keychain，在 Cursor 與 OpenClaw 中接 OpenRouter 而不污染正式設定檔，並以真實 macOS 介面驗證多模型 Agent 工作流。定價細節見 Mac mini M4 價格指南與彈性租賃 TCO 分析。

14 · 參考來源

最後更新：2026-07-24｜定價與模型數量依 OpenRouter 官方文件為準