OpenRouter 把 OpenAI、Anthropic、Google 等厂商的模型收斂到一條 OpenAI 相容 API:改 base_url 和 model 就能在 GPT、Claude、Gemini 之間切換,不必為每個平台單獨開戶。本文是 2026 年實操向教學:从 openrouter.ai 註冊、充值、建立 API Key,到在控制台选模型,並用 curl / Python 完成第一次調用。單價與月度帳單推演見 OpenRouter 價格對比;若你主要用 Claude Code 訂閱,可對照 Claude Code 2026 费用。
https://openrouter.ai/api/v1OpenRouter 適合谁、和直連厂商 API 的區別
OpenRouter 是託管聚合商:你向 OpenRouter 預充值,請求經其路由到具體供應商;計費按各模型在 OpenRouter 上標註的输入/輸出 token 單價扣餘額。適合:
- 想一個 Key、多模型試錯(例如白天用便宜 Gemini Flash,晚上用 Claude Sonnet 寫程式)
- 所在地區不方便分別開通 OpenAI / Anthropic / Google 帳單
- 自建 Agent 或腳本,已按
openaiSDK 寫好,只想改 endpoint
不適合:強合規要求「資料絕不經過第三方中轉」、或企業已與某一家簽了獨占折扣——那時应直連厂商或使用自託管網關(如 OmniRoute)。
和「只買 Claude Pro」怎麼選?
Claude Code 的 Pro/Max 是固定月費 + 用量池,適合天天在終端機里寫程式。OpenRouter 是純按量,適合腳本、多模型路由、或用量波動大的實驗。兩者可以並存:IDE 用訂閱,CI/批次處理走 OpenRouter。整月帳單怎麼疊,見 AI 编程一個月真實成本。
註冊帳號與登入方式
- 打開 openrouter.ai,點擊 Sign in。
- 可用 Google、GitHub 或電子郵件註冊;團隊建议用公司邮箱并開啟 2FA(在 Account → Security)。
- 登入后進入 Dashboard,左側可見 Credits、Keys、Activity。
註冊本身不收費;未充值前部分免費模型可能可用,但生產環境应假設需要正餘額才能穩定調用付費模型。
充值、餘額與消费提醒
路徑一般為 Settings → Credits 或 Dashboard 頂部的 Add Credits。支援信用卡等支付方式(以控制台當時選項為準)。
- 預充值模型:餘額不足時請求会失敗,不會在事後寄帳單。
- 手續費:部分充值通道会加收约 5.5% 一類费用,實際到账 credits 少於支付金額——算單價時要把这层算進去,详見 價格對比文。
- 用量查看:Activity / Usage 可按 Key、模型、時间篩選,便於對照日志排錯。
建立與管理 API Key
- 打開 Keys → Create Key。
- 為 Key 起名(如
cursor-dev、ci-nightly),便於在 Activity 里區分。 - 若控制台提供 限額 / 過期時间,给 CI 或實習生 Key 設上限。
- 複製 Key,只保存在密碼管理器或密鑰儲存庫;不要提交到 Git。
調用時在 HTTP Header 使用:
Authorization: Bearer <OPENROUTER_API_KEY>
可選但推薦同時带上(用于 OpenRouter 排行與策略,部分模型要求):
HTTP-Referer: https://your-app.example
X-Title: Your App Name
在模型目錄里选 GPT / Claude / Gemini
打開 Models 页,搜尋或按提供商篩選。請求里的 model 欄位使用斜線 ID,例如:
| 家族 | 示例 model ID(2026 控制台常見写法) | 說明 |
|---|---|---|
| Claude | anthropic/claude-sonnet-4.5 | 编码與推理均衡;具體版本以目錄為準 |
| GPT | openai/gpt-5 或 openai/gpt-5-mini | 按任務选旗艦或 mini |
| Gemini | google/gemini-2.5-pro、google/gemini-2.5-flash | Flash 適合高吞吐、低成本 |
目錄会顯示每百萬 token 的输入/輸出价與上下文长度。同一邏輯名可能有多個路由(不同供應商副本);生產環境請固定 ID,不要依賴「自動最新」別名。
第一次調用:curl 與 Python
端點:
POST https://openrouter.ai/api/v1/chat/completions
Body 與 OpenAI Chat Completions 相同:model、messages,可選 stream: true。
調用 Claude(Anthropic)
curl https://openrouter.ai/api/v1/chat/completions \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
-H "Content-Type: application/json" \
-H "HTTP-Referer: https://localhost" \
-H "X-Title: Dev Test" \
-d '{
"model": "anthropic/claude-sonnet-4.5",
"messages": [{"role": "user", "content": "用三句話解釋 OpenRouter"}]
}'
調用 GPT(OpenAI)
curl https://openrouter.ai/api/v1/chat/completions \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/gpt-5-mini",
"messages": [{"role": "user", "content": "写一個 Python hello world"}]
}'
調用 Gemini(Google)
curl https://openrouter.ai/api/v1/chat/completions \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "google/gemini-2.5-flash",
"messages": [{"role": "user", "content": "總結 REST 與 GraphQL 各一個優點"}]
}'
Python(官方 openai SDK):
from openai import OpenAI
client = OpenAI(
base_url="https://openrouter.ai/api/v1",
api_key=os.environ["OPENROUTER_API_KEY"],
)
resp = client.chat.completions.create(
model="anthropic/claude-sonnet-4.5",
messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)
若返回 402 或餘額相關錯誤,先回 Dashboard 查 Credits;若 404 模型不存在,說明 ID 已更名——回到 Models 页複製最新 ID。
接入 Cursor、Claude Code 與其它客户端
- Cursor / Cline / 自写 Agent:在「OpenAI 相容」或「Override OpenAI Base URL」裡填
https://openrouter.ai/api/v1,API Key 填 OpenRouter Key,Model 填上文的斜線 ID。 - Claude Code:官方預設走 Anthropic 訂閱;若要用 OpenRouter,需按 Anthropic 相容或项目文件設定自訂 endpoint(變更頻繁,以你本機
claudeCLI 說明為準)。多數團隊更傾向:終端機用 Claude Code 訂閱,腳本用 OpenRouter。 - 環境变量:在雲端 Mac 或 CI 里用
OPENROUTER_API_KEY,配合密鑰注入,避免寫進儲存庫。
常見問題
OpenRouter 的 Key 能代替 OpenAI 官方 Key 吗?
在相容客户端里可以:把 base URL 指到 OpenRouter 即可。但計費、可用模型清單、資料路由策略都以 OpenRouter 為準,與 OpenAI 控制台無關。
串流輸出怎麼開?
請求 JSON 加 "stream": true,按 OpenAI SSE 格式讀增量;SDK 通常有 stream=True 參數。
如何控制成本?
為每個環境單獨 Key、設限額;預設用 Flash / mini 類模型,僅在評測通過後再切旗艦;長上下文任務先估算 token,對照 價格表。
和直連 Anthropic API 的 /v1/messages 一樣嗎?
OpenRouter 主路徑是 /v1/chat/completions。若客戶端只支援 Anthropic Messages,查 OpenRouter 文件是否提供對應相容路由;否則用 OpenAI 相容层或換 SDK。