
OpenRouter 使用教程:注册、支付宝充值到 API 调用全流程(2026)
这篇教程带你完成 OpenRouter 的最小可用流程:注册 → 创建 API Key → 跑通免费调用 → 按需充值和接入工具。示例使用当前仍可用的 openrouter/free 自动路由,避免照抄已经下架的旧模型 ID。
核对于 2026 年 11 月 12 日。接口和支付规则以 OpenRouter 官方页面为准。
准备工作
- 一个可接收验证信息的邮箱;
- 能正常打开 openrouter.ai 的网络;
- 可选:官方结账页支持的支付方式。
注册本身不要求先充值。建议先跑通免费调用,再决定是否购买 Credits。
第 1 步:注册账号
- 打开 OpenRouter 官网。
- 使用支持的登录方式完成注册。
- 进入控制台,确认可以查看模型、Activity 和设置页面。
不要通过第三方「共享账号」或「成品 Key」开始,后续无法可靠控制额度和数据权限。
第 2 步:创建 API Key
- 打开 API Keys 设置页。
- 创建一个新的 Key,并按用途命名,例如
local-test。 - 立即保存明文 Key,不要贴进公开仓库、网页前端或聊天记录。
- 如果怀疑泄露,在控制台吊销后重建。
不同项目可以使用不同 Key,但 Key 数量不会增加账号的免费请求额度。
第 3 步:跑通第一次免费调用
Base URL 统一使用:
https://openrouter.ai/api/v1
模型先使用:
openrouter/free
cURL 示例
把 YOUR_API_KEY 换成自己的 Key:
curl https://openrouter.ai/api/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openrouter/free",
"messages": [{"role": "user", "content": "用一句话解释什么是 API"}]
}'
Python 示例
先安装 OpenAI SDK,再运行:
from openai import OpenAI
client = OpenAI(
base_url="https://openrouter.ai/api/v1",
api_key="YOUR_API_KEY",
)
response = client.chat.completions.create(
model="openrouter/free",
messages=[{"role": "user", "content": "用一句话解释什么是 API"}],
)
print(response.choices[0].message.content)
生产代码请通过环境变量或密钥管理工具读取 Key,不要硬编码。
第 4 步:按需购买 Credits
如果免费模型已经满足测试需求,可以跳过这一步。
需要付费模型或更高免费每日档位时:
- 打开 Credits 页面。
- 查看当前结账页支持的支付方式。官方 FAQ 列出主流信用卡、AliPay 和 USDC。
- 核对金额和手续费。普通 Credits 购买当前为 5.5%,最低 0.80 美元。
- 完成支付后,在 Activity 中查看到账和消耗。
免费模型当前每日限流为:累计购买不足 10 美元时 50 次,达到门槛后 1000 次,每分钟均为 20 次。具体以 GET /api/v1/key 返回为准。
第 5 步:接入 Claude Code、Cursor 等工具
不同客户端的自定义模型入口会变化,配置时只抓住四个字段:
| 字段 | 填写内容 |
|---|---|
| API Key | 你刚创建的 OpenRouter Key |
| Base URL | https://openrouter.ai/api/v1 |
| Model | 测试用 openrouter/free,生产选具体可用模型 |
| 协议 | 优先选 OpenAI 兼容;使用 Anthropic 端点时查官方对应文档 |
保存后先跑一个短任务,再开启长 Agent 工作流。Agent 一次任务可能连续触发多次请求,很快消耗免费每日额度。
怎么查剩余免费次数
使用自己的 Key 调用:
curl https://openrouter.ai/api/v1/key \
-H "Authorization: Bearer YOUR_API_KEY"
重点查看 free_model_daily_requests 里的 used、limit 和 remaining。
常见报错排查
| 报错 | 常见原因 | 处理 |
|---|---|---|
| 401 | Key 错误、失效或请求头不正确 | 检查 Bearer Key,必要时吊销重建 |
| 402 | 余额不足、Key 消费上限或在途预算不足 | 查看余额和 Key 限制,降低请求成本或按需充值 |
| 404 | 模型 ID 不存在或已下架 | 回 Models 页面复制当前 ID,测试可先用 openrouter/free |
| 429 | 免费限流、上游容量不足或请求过快 | 查看剩余次数,按 Retry-After 指数退避并准备备用模型 |
| 超时 | 网络、上游模型或任务过长 | 缩短输入、开启流式、调整超时并测试其他模型 |
总结
最稳的上手顺序是:先创建 Key,用 openrouter/free 跑通,再按需购买 Credits 和选择具体模型。不要把旧教程的模型 ID、网络结果和免费数量当成长期不变的信息。
官方来源
最后更新:2026 年 11 月 12 日。
常见问题
不充值能用吗?
能。可以先使用当前免费模型,未达充值门槛时免费模型每天 50 次、每分钟 20 次。
为什么旧教程里的免费模型调不通?
免费列表会变化。旧文中的 `z-ai/glm-5.2:free`、`minimax/minimax-m3:free` 和 `stealth/ox-alpha` 已不在本次核对的公开清单中。
支付宝一定可以选吗?
官方 FAQ 列出 AliPay,但实际结账选项可能受账号和地区影响,以你的官方结账页为准。
免费模型能用于生产吗?
不建议把不稳定的免费条目作为唯一生产线路。生产应使用明确模型、监控费用,并准备备用方案。

京ICP备2024094994号-29