OpenRouter 完整教學
從零到一接入 GPT / Claude / Gemini 全模型 + 雙語 SEO 實戰（2026）

OpenRouter 是什麼？統一呼叫 GPT / Claude / Gemini 的 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、deepseek/deepseek-chat

雙層路由機制：Model Routing + Provider Routing

OpenRouter 內部做了兩件獨立的路由決策——這是理解其技術價值的關鍵：

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

開發者接入前必須知道的六大痛點

1. 01

   多廠商帳號碎片化：OpenAI、Anthropic、Google 各需獨立註冊、Key 管理與 SDK 適配，Agent 框架切換模型時程式碼改動大。

2. 02

   單一供應商限流/宕機：直連 API 時業務程式碼須自己寫 circuit breaker 與重試邏輯，生產可用性難保障。

3. 03

   帳單分散對帳：5 個後台分別看消耗、延遲與成本，中小團隊財務口徑難統一。

4. 04

   聚合服務 token 加價：多數同類閘道會在 token 單價上加價，長期成本不透明。

5. 05

   閘道額外延遲：OpenRouter 閘道會增加約 10–80ms 跳數，對延遲極度敏感的場景需評估。

6. 06

   資料合規中間層：流量經過美國第三方閘道，有資料駐留要求的場景可能不符合合規。

實戰教學：6 步接入 OpenRouter API + 全套程式碼範例

1. 01

   註冊帳號：造訪 openrouter.ai，用 GitHub 或電子郵件註冊。

2. 02

   建立 API Key：進入 Keys 頁面，產生 Key 並妥善保存（只顯示一次）。

3. 03

   儲值 Credits（可選）：呼叫付費模型需儲值；免費模型可跳過此步（有頻率限制）。

4. 04

   發起第一次請求：用下方 cURL 或 SDK 範例驗證 Key 有效。

5. 05

   設定 OpenAI SDK 零成本遷移：僅改 base_url 與 api_key，建議攜帶 HTTP-Referer 與 X-Title 標頭（OpenRouter 用於排行榜統計）。

6. 06

   生產部署 Fallback 鏈：設定 models 陣列 + route: "fallback"，查詢可用模型列表 GET /api/v1/models。

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

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"])

Python（OpenAI SDK 零成本遷移——重點）

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)

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

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

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

查詢可用模型列表（實用小技巧）

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

雙語 SEO 實戰：為什麼英文頁面流量低 + 可執行優化清單

若你用 OpenRouter 搭建 Agent 的同時維護自建雙語部落格，英文頁面訪問量低通常不是單一原因。以下診斷清單按優先級排列（性價比從高到低）：

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

• CDN/WAF 攔截 Googlebot：亞太 CDN + WAF 可能把海外 IP 判定為攻擊流量，出口頻寬與路由策略也會影響抓取，用 Google Search Console「網址檢查」實測抓取效果。
• 缺少 hreflang 標註：Google 可能只收錄繁中版，英文版被當成重複內容。推薦子目錄結構 /zh-Hant/ 與 /en/，互相宣告 hreflang="zh-Hant" 與 hreflang="en"，並設 x-default。
• robots.txt / noindex 誤設定：檢查是否把 /en/ 路徑 disallow 了。
• sitemap 缺英文條目：中英文各自獨立列出，帶 <xhtml:link> alternate 標註。
• CSR 空殼 HTML：純前端渲染頁面爬蟲可能拿到空殼，須 SSR/SSG。

P1：內容層——英文必須本地化重寫，不能機翻

中文標題「OpenRouter 優勢」直譯成 "OpenRouter Advantages" 無法匹配英文搜尋習慣；英文使用者更常搜 "OpenRouter vs OpenAI API" 或 "is OpenRouter worth it"。2026 年 Google AI Mode 會把一次搜尋拆解成多個子問題（query fan-out），內容須涵蓋「是什麼、怎麼用、多少錢、和誰比、安全嗎、局限是什麼」全部子意圖。

結構化資料（Schema）建議

至少植入 BlogPosting/TechArticle + FAQPage JSON-LD。FAQ 問句用真實口語表達（英文："Is OpenRouter free?" 而非 "Free usage of OpenRouter"）。繁中版 FAQ 用中文長尾詞原句。

發布與分發渠道

可執行行動 Checklist + 效果追蹤

• P0 本週：GSC 檢查英文頁面抓取索引 → 排查 CDN/WAF → 補全 hreflang/canonical/sitemap
• P1 寫作：中英文分別獨立成稿（共享程式碼範例，文字本地化重寫）→ 嵌入關鍵詞 → 加 Article + FAQPage Schema
• P2 分發：繁中發 PTT/技術社團；英文發 dev.to；兩語言 sitemap 提交 GSC
• 追蹤指標：GSC 按 /en/ 與 /zh-Hant/ 分別看 Impressions/CTR——展現量為 0 是收錄問題，展現高 CTR 低是標題/描述問題；站內統計分語言看自然搜尋流量與跳出率

可引用硬核資料（EEAT）

• 模型規模：70+ 供應商、400+ 模型，統一 Endpoint 一個 Key 呼叫
• 閘道延遲：額外約 10–80ms 跳數（對比直連官方 API）
• 儲值手續費：5.5%（最低 $0.80）；BYOK 每月前 100 萬次請求免服務費
• 免費檔額度：未儲值 50 次/天 → 儲值 ≥$10 後 1000 次/天、20 次/分鐘

OpenRouter 適合快速驗證多模型 Agent 原型，但若你的 Agent 需要7×24 常駐執行、穩定 SSH 長連線與 iOS/macOS 原生建置環境，在 Linux 伺服器（VPS）上跑 CLI Agent 往往面臨 Metal 不可用、Xcode 缺失與 Keychain 隔離等硬限制。對於更穩定、更適合 iOS CI/CD 與 AI Agent 自動化的生產環境，NodeMini 的 Mac Mini 雲端租賃通常是更優解——獨佔 Apple Silicon 算力、秒級撥備，像租 VPS 一樣按需使用遠端 Mac 節點。詳見 租賃價格說明。