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。