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

OpenRouter 是統一 LLM API 聚合層：用一組 API Key + 一個 OpenAI 相容 Endpoint 呼叫來自多家供應商的能力，而不必分別對接 OpenAI、Anthropic、Google、Meta、DeepSeek 等官方 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

OpenRouter 內部做兩層獨立路由決策——這是理解其可用性的關鍵：

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

OpenRouter 並非取代官方 SDK，而是在「多模型場景」與「官方直連」之間提供折中——下文對比表會說明何時該用、何時不該用。

• 痛點一：多廠商帳號碎片化。直連需分別註冊 OpenAI、Anthropic、Google 等，Key 輪替、帳單對帳、權限稽核成本高。
• 痛點二：換模型等於換整合層。不同廠商訊息格式、串流協定、錯誤碼不一致，Agent 框架難以「改一個字串就換模型」。
• 痛點三：單點限流拖垮正式環境。單一供應商 429/5xx 時，業務程式碼若未內建重試與切換，使用者直接看到失敗。
• 痛點四：成本透明度差。分散在五個後台的用量，很難做統一的 TTFT、吞吐與 spend 分析。

選型結論預覽：多模型 A/B、中小體量、需要 Fallback 時優先 OpenRouter；單一旗艦超大體量、極致延遲或嚴格資料駐留時直連更優——詳見下一節「什麼時候不該用」。

• 優勢一：一組 Key 打通所有模型。換模型 = 改 model 字串，無需重寫業務邏輯或廠商適配層。
• 優勢二：跨供應商自動 Failover。可設定 models: ["anthropic/claude-3.5-sonnet", "openai/gpt-4o", "google/gemini-2.5-pro"]，主力掛了依次嘗試。
• 優勢三：統一帳單與用量分析。一個 Dashboard 看全模型 token、成本、TTFT 與吞吐，不用登入五個後台對帳。
• 優勢四：無 token 加價。FAQ 明確不在單價上加價，僅儲值環節 5.5%；中大體量可用 BYOK 降本。
• 優勢五：場景邊界清晰。適合快速原型、多模型對比、月消費幾千美元以內、同一 Prompt 框架跑遍市面模型。

更適合直連官方 API 的情況（建立 E-E-A-T 的平衡視角）：

• 單一模型、月消費數萬美元以上——5.5% 手續費已值得自建直連
• 需要 Anthropic Prompt Caching、OpenAI Batch/Assistants、Google Vertex 專屬工具鏈
• 對延遲極度敏感（閘道 +10–80ms 不可接受）
• 資料合規 / 資料駐留不允許流量經美國第三方中間層

寫「什麼時候不該用」不是勸退，而是涵蓋 OpenRouter vs 直連 API 等高轉化長尾詞，並提升 AI 摘要引用的可信度。

1. 註冊帳戶：造訪 openrouter.ai，用 GitHub 或電子郵件建立帳戶。
2. 建立 API Key：在 Keys 頁面產生 Key，正式環境按專案拆分 Key 並設定 spend limit。
3. 設定環境變數：export OPENROUTER_API_KEY="sk-or-..."，勿把 Key 提交進 Git。
4. 發起第一次請求：用下方 curl 或 OpenAI SDK 驗證 200 回應與模型 ID 正確。
5. 查詢可用模型：curl https://openrouter.ai/api/v1/models -H "Authorization: Bearer $OPENROUTER_API_KEY"，確認目標模型 slug 存在。
6. 正式部署：設定 Fallback 鏈、串流輸出、HTTP-Referer/X-Title 標頭（OpenRouter 建議攜帶用於排行榜統計），並將 Key 注入 7×24 Agent 宿主而非個人筆電。

以下範例涵蓋「how to」與「code example」兩類搜尋意圖；程式碼可原樣執行，僅需替換 Key。

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

Python（requests 原生）

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

Python（OpenAI SDK 零成本遷移——高頻搜尋場景）

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://jexcloud.com", "X-Title": "JEXCLOUD Demo"},
)

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" }],
});

串流輸出（Streaming）

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

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

• 供應商規模：70+ 家供應商、400+ 模型（官方文件口徑，路由前請用 /models 覆核）。
• 免費檔：25+ 免費模型；未儲值約 50 次/天，儲值 ≥$10 後約 1000 次/天、20 次/分鐘。
• 手續費：儲值 Credits 5.5%（最低 $0.80）；加密貨幣 +5%；BYOK 每月前 100 萬次免費。
• 延遲代價：閘道層通常增加約 10–80ms，對 TTFT 敏感場景需實測。
• 成本控制：預設路由指向 Flash/低價模型；高風險步驟再升 Opus；啟用專案級 spend limit 與週報匯出。

OpenRouter 不在 token 單價上加價——這是與多數聚合服務的關鍵差異；真正要算的是儲值手續費 + 閘道延遲 + 合規邊界，而非「模型標價 × 神秘係數」。

OpenRouter 收費嗎？ 有免費模型與付費模型；付費按供應商 token 原價，儲值收 5.5%。

OpenRouter 台灣/香港能用嗎？ 通常可 API 呼叫，但需自行評估網路與資料跨境合規。

OpenRouter 支援哪些模型？ 400+ 模型，格式 vendor/model；用 /api/v1/models 拉全量列表。

OpenRouter 和 Claude 直連哪個好？ 多模型與容災選 OpenRouter；官方專屬能力與超大體量選直連。

OpenRouter 一個月多少錢？ 取決於模型與用量——Flash 檔 Agent 可能幾十美元，全 Opus 可能數千；Dashboard 可預估。

OpenRouter 安全嗎？ 流量經閘道轉發；敏感資料請評估 BYOK、直連或私有部署。

OpenRouter Python 怎麼呼叫？ 見第五節 requests 或 OpenAI SDK 範例。

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

• CDN/WAF 攔截 Googlebot——用 Google Search Console「網址檢查」實測，比瀏覽器開啟更可靠
• 中英文缺少正確 hreflang，Google 可能只收錄中文版為規範版本
• robots.txt / noindex 誤傷 /en/ 路徑
• sitemap.xml 未分語言列出或未帶 alternate 標註
• 純 CSR 空殼 HTML，爬蟲拿不到正文

內容層：

• 英文為中文直譯，關鍵字不匹配 OpenRouter vs OpenAI API、is OpenRouter worth it 等原生表達
• 缺少英文獨立關鍵字研究；E-E-A-T 不足（無作者、無實測數據）

權重與外鏈層：

• 中文在掘金/知乎/V2EX 有分發，英文未在 Reddit / Hacker News / dev.to 曝光，英文頁幾乎零外鏈
• 新網域需時間 + 外鏈 + 持續更新才能提高抓取頻率

建議修復順序（性價比從高到低）：

1. GSC 檢查英文 URL 是否被抓取、是否已索引
2. 排查 CDN/WAF 對 Googlebot 的攔截
3. 補齊 hreflang、canonical、分語言 sitemap
4. 重寫 3–5 篇重點英文文（非翻譯），對齊英文關鍵字
5. 在 dev.to / Reddit / Hacker News 做首批英文分發

中文核心詞：OpenRouter、OpenRouter API、OpenRouter 教學；中腰部：OpenRouter 怎麼用、和 OpenAI 的差別、免費模型、收費嗎；長尾 FAQ：API Key 怎麼取得、台灣香港能用嗎、Python 怎麼呼叫。

中文標題信號詞：完整指南、入門完整教學、從 0 到 1、2026 最新——核心詞須在標題、首段、H2 原樣出現（百度字面匹配 + AI 搜尋語意叢集雙下注）。

英文核心詞：OpenRouter API、tutorial、integration；對比類：OpenRouter vs OpenAI API、is OpenRouter worth it；how-to：OpenRouter Python example、fallback routing、streaming response。

英文標題信號詞：The Complete Guide、Step-by-Step、For Beginners、Honest Review——勿堆砌 Ultimate+Complete+Beginner（英文讀者對標題黨容忍度更低）。

本地化原則：中英文不要簡單互譯——共享程式碼範例，但標題、首段、H2、FAQ 問句按各自搜尋意圖重寫；英文首段用 TL;DR 定義塊；加入「When NOT to use it」平衡視角；Meta Description 中文 150–160 字、英文 150–160 字元含 step-by-step / honest 等信任詞。

推薦 URL 結構（子目錄共享網域權重）：

https://jexcloud.com/zh/blog/2026-0724-openrouter-api-tutorial-gpt-claude-gemini-guide.html
https://jexcloud.com/en/blog/2026-0724-openrouter-api-tutorial-gpt-claude-gemini-guide.html

hreflang 範例（各語言頁 head 互指 + x-default）：

<link rel="alternate" hreflang="zh-Hans" href="https://jexcloud.com/zh/blog/..." />
<link rel="alternate" hreflang="en" href="https://jexcloud.com/en/blog/..." />
<link rel="alternate" hreflang="x-default" href="https://jexcloud.com/en/blog/..." />

每語言 canonical 指向自身；sitemap 中各語言獨立 <url> 並宣告 xhtml:link alternate。

Schema：本文已含 BlogPosting + FAQPage JSON-LD；繁體中文版 FAQ 問句用中文長尾原句。

分發渠道：繁體中文 → PTT、Facebook 社團、Medium、Google Search Console；簡體中文 → 掘金、知乎、V2EX、CSDN；英文 → dev.to（帶 canonical 回鏈）、Hacker News、Reddit（r/LocalLLaMA 等）、Indie Hackers；X 可發雙語線程摘要。

P0（本週止血）：GSC 查英文抓取/索引 → 排查 CDN/WAF → 補 hreflang/canonical/sitemap。

P1（寫作發布）：中英文分別成稿（英文本地化重寫）→ 嵌入關鍵字 → Article + FAQPage Schema。

P2（分發追蹤）：PTT/Medium + dev.to/Reddit → 雙語言 sitemap 提交 GSC → 分路徑看 Impressions/CTR/排名。

效果追蹤：GSC 按 /en/ 與 /zh/ 看展現量（0 = 收錄問題，高展現低 CTR = 標題問題）；站內 Umami/GA4 分語言看自然搜尋與跳出率；每月無痕搜尋 3–5 個核心詞抽查排名。

跑 OpenRouter Agent 時，個人 Mac 合蓋即斷流；超賣 VPS 常非官方 macOS，SSH 抖動會打斷多步工具循環；團隊共用機器則 Key 輪替與 CLI 版本難以統一——這些與「API 怎麼接」無關、卻決定正式環境可用性。共享 VPS 還常見頻寬抖動、超賣導致的長連線中斷等問題。

對需要 7×24 跑 Cursor Agent、OpenClaw Gateway 與 OpenRouter 路由 的團隊，JEXCLOUD 多區域裸金屬 Mac 是更穩的宿主：獨占 Apple Silicon、真 macOS、120 秒交付、按月彈性；模型帳單走 OpenRouter，算力走裸金屬，分層清晰。規格見 定價頁，接入見 說明中心。