OpenRouter 使用教程:注册、支付宝充值到 API 调用全流程(2026)封面图
AI 编程约 10 分钟

OpenRouter 使用教程:注册、支付宝充值到 API 调用全流程(2026)

AI 指南··◉ 0 浏览

这篇教程带你完成 OpenRouter 的最小可用流程:注册 → 创建 API Key → 跑通免费调用 → 按需充值和接入工具。示例使用当前仍可用的 openrouter/free 自动路由,避免照抄已经下架的旧模型 ID。

核对于 2026 年 11 月 12 日。接口和支付规则以 OpenRouter 官方页面为准。

准备工作

  • 一个可接收验证信息的邮箱;
  • 能正常打开 openrouter.ai 的网络;
  • 可选:官方结账页支持的支付方式。

注册本身不要求先充值。建议先跑通免费调用,再决定是否购买 Credits。

第 1 步:注册账号

  1. 打开 OpenRouter 官网。
  2. 使用支持的登录方式完成注册。
  3. 进入控制台,确认可以查看模型、Activity 和设置页面。

不要通过第三方「共享账号」或「成品 Key」开始,后续无法可靠控制额度和数据权限。

第 2 步:创建 API Key

  1. 打开 API Keys 设置页。
  2. 创建一个新的 Key,并按用途命名,例如 local-test。
  3. 立即保存明文 Key,不要贴进公开仓库、网页前端或聊天记录。
  4. 如果怀疑泄露,在控制台吊销后重建。

不同项目可以使用不同 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

如果免费模型已经满足测试需求,可以跳过这一步。

需要付费模型或更高免费每日档位时:

  1. 打开 Credits 页面。
  2. 查看当前结账页支持的支付方式。官方 FAQ 列出主流信用卡、AliPay 和 USDC。
  3. 核对金额和手续费。普通 Credits 购买当前为 5.5%,最低 0.80 美元。
  4. 完成支付后,在 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、网络结果和免费数量当成长期不变的信息。

官方来源

  1. OpenRouter FAQ
  2. Credit Limits and Rate Limits
  3. OpenRouter 完整指南

最后更新:2026 年 11 月 12 日。

常见问题

不充值能用吗?

能。可以先使用当前免费模型,未达充值门槛时免费模型每天 50 次、每分钟 20 次。

为什么旧教程里的免费模型调不通?

免费列表会变化。旧文中的 `z-ai/glm-5.2:free`、`minimax/minimax-m3:free` 和 `stealth/ox-alpha` 已不在本次核对的公开清单中。

支付宝一定可以选吗?

官方 FAQ 列出 AliPay,但实际结账选项可能受账号和地区影响,以你的官方结账页为准。

免费模型能用于生产吗?

不建议把不稳定的免费条目作为唯一生产线路。生产应使用明确模型、监控费用,并准备备用方案。

评论 (0)

?
0/1

还没有评论,来发第一条吧

网站上的服务均为第三方提供,
请用户注意自行甄别。

北京酷讯互动科技有限公司

备案京ICP备2024094994号-29

© 2026 AI345 · All Rights Reserved

用户服务协议·隐私政策