Zilmac 博客
← 返回技術實踐

OpenRouter API 教學 2026:註冊、充值、API Key、模型選擇與 GPT/Claude/Gemini 調用

API 與 Agent ·約 12 分鐘閱讀

OpenRouter 多模型 API 網關介面與開發者設定 GPT Claude Gemini 路由

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 费用。

1
條 API:https://openrouter.ai/api/v1
300+
可路由模型(含多厂商 GPT / Claude / Gemini)
預充值
按 token 扣費;充值通道可能含手續費

OpenRouter 適合谁、和直連厂商 API 的區別

OpenRouter 是託管聚合商:你向 OpenRouter 預充值,請求經其路由到具體供應商;計費按各模型在 OpenRouter 上標註的输入/輸出 token 單價扣餘額。適合:

  • 想一個 Key、多模型試錯(例如白天用便宜 Gemini Flash,晚上用 Claude Sonnet 寫程式)
  • 所在地區不方便分別開通 OpenAI / Anthropic / Google 帳單
  • 自建 Agent 或腳本,已按 openai SDK 寫好,只想改 endpoint

不適合:強合規要求「資料絕不經過第三方中轉」、或企業已與某一家簽了獨占折扣——那時应直連厂商或使用自託管網關(如 OmniRoute)。

和「只買 Claude Pro」怎麼選?

Claude Code 的 Pro/Max 是固定月費 + 用量池,適合天天在終端機里寫程式。OpenRouter 是純按量,適合腳本、多模型路由、或用量波動大的實驗。兩者可以並存:IDE 用訂閱,CI/批次處理走 OpenRouter。整月帳單怎麼疊,見 AI 编程一個月真實成本。

註冊帳號與登入方式

  1. 打開 openrouter.ai,點擊 Sign in。
  2. 可用 Google、GitHub 或電子郵件註冊;團隊建议用公司邮箱并開啟 2FA(在 Account → Security)。
  3. 登入后進入 Dashboard,左側可見 Credits、Keys、Activity。

註冊本身不收費;未充值前部分免費模型可能可用,但生產環境应假設需要正餘額才能穩定調用付費模型。

充值、餘額與消费提醒

路徑一般為 Settings → Credits 或 Dashboard 頂部的 Add Credits。支援信用卡等支付方式(以控制台當時選項為準)。

  • 預充值模型:餘額不足時請求会失敗,不會在事後寄帳單。
  • 手續費:部分充值通道会加收约 5.5% 一類费用,實際到账 credits 少於支付金額——算單價時要把这层算進去,详見 價格對比文。
  • 用量查看:Activity / Usage 可按 Key、模型、時间篩選,便於對照日志排錯。
開發者查看 OpenRouter API 用量儀表板與多模型 token 計費曲線
養成習慣:每次調大 Agent 併發前先看 Credits 與 Activity,避免餘額在週末跑批時耗盡

建立與管理 API Key

  1. 打開 Keys → Create Key。
  2. 為 Key 起名(如 cursor-dev、ci-nightly),便於在 Activity 里區分。
  3. 若控制台提供 限額 / 過期時间,给 CI 或實習生 Key 設上限。
  4. 複製 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 控制台常見写法)說明
Claudeanthropic/claude-sonnet-4.5编码與推理均衡;具體版本以目錄為準
GPTopenai/gpt-5 或 openai/gpt-5-mini按任務选旗艦或 mini
Geminigoogle/gemini-2.5-pro、google/gemini-2.5-flashFlash 適合高吞吐、低成本

目錄会顯示每百萬 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(變更頻繁,以你本機 claude CLI 說明為準)。多數團隊更傾向:終端機用 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。

限時特惠

Zilmac

雲端 Mac、遠端開發與 Mac VPS,為 iOS 與跨平台團隊補齊 Apple 工具鏈。

返回首頁
限時優惠 點擊查看套餐