OpenRouter 使用教程：注册、支付宝充值到 API 调用全流程（2026 实测）

OpenRouter 用一个 API Key 就能调用 GPT-5.6、Claude、Gemini、DeepSeek、GLM 等 400 多个大模型，而且支持支付宝充值、国内可以直连。这篇教程带你从零开始：注册账号 → 支付宝充值 → 创建 API Key → 跑通第一次调用 → 接入 Claude Code / Cursor 等常用工具，全流程 2026 年 8 月 26 日实测有效，10~15 分钟可以走完。

本文速览：

• 第 1 步：注册（2 分钟，无需绑卡）
• 第 2 步：支付宝充值 $10（强烈建议，解锁免费模型每天 1000 次额度）
• 第 3 步：创建 API Key（1 分钟）
• 第 4 步：跑通第一次调用（curl / Python / 网页版三选一）
• 第 5 步：接入 Claude Code、Cursor、Cherry Studio
• 附录：常见报错排查 + FAQ

还不了解 OpenRouter 是什么、免费额度怎么算的，先看这篇：《OpenRouter 是什么？免费额度、价格与 400+ 模型调用全解》。

准备工作

开始前确认三件事：

1. 一个邮箱：推荐 Gmail 或 Outlook；国内邮箱（QQ、163）多数情况也能收到验证邮件，但海外邮箱更稳
2. 网络能打开 openrouter.ai：2026 年 8 月 26 日实测国内可直连（官网、API 均正常，API 首字节延迟 0.6~0.9 秒）；如果你所在网络打不开，切换网络即可
3. 想充值的话：准备支付宝或一张信用卡；不想充值也行，注册后直接用免费模型（每天 50 次）

第一步：注册 OpenRouter 账号（2 分钟）

1. 打开 https://openrouter.ai，点击右上角 Sign Up
2. 选择 Continue with Google 一键注册（最快），或用邮箱注册（会收到一封验证邮件，点击链接激活）
3. 登录成功后进入控制台首页

注册完全免费，不需要绑定任何支付方式。如果你只是想白嫖免费模型，到这里就已经可以开始用了——直接跳到第三步创建 API Key。

第二步：用支付宝充值（可选，但强烈建议）

为什么建议充 $10

• 免费模型额度从 每天 50 次提升到每天 1000 次（按累计充值判断，余额花完也不降级）
• 充进的 $10 余额可以直接调用全部 400+ 付费模型，按量扣费

充值步骤

1. 登录后进入 Credits 页面：点头像 → Credits，或直接访问 openrouter.ai/credits
2. 输入充值金额（个人起步建议 10 美元）
3. 进入 Stripe 结账页，在支付方式中选择 Alipay（支付宝）
4. 用支付宝 App 扫码完成支付
5. 余额一般即时到账；Stripe 偶尔有延迟，官方说明最多等 1 小时

手续费：充值收 5.5%（最低 $0.80），充 $10 实际支付约 $10.55（约合人民币 75 元）。也可以选信用卡直接支付；USDC 加密货币手续费 5%。

退款规则：24 小时内未使用的余额可申请退款（手续费不退），加密货币支付不可退——所以第一次别充太多，先用小金额跑通。

第三步：创建 API Key（1 分钟）

1. 进入 API Keys 页面：点头像 → API Keys，或直接访问 openrouter.ai/settings/keys
2. 点击 Create Key，给 Key 起个名字（如 my-app）
3. 复制生成的 Key 并妥善保存：以 sk-or-v1- 开头，只在创建时完整显示一次

两条安全红线：

• 不要把 Key 提交到 Git 仓库（建议加进 .gitignore）
• 不要把 Key 写在前端网页代码里，它会直接暴露

第四步：跑通第一次 API 调用（3 分钟）

OpenRouter 的接口与 OpenAI 完全兼容，三种方式任选。下面的示例统一使用免费模型 z-ai/glm-5.2:free，不消耗余额。

方式一：curl（最直接）

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-or-v1-你的Key" \
  -d '{
    "model": "z-ai/glm-5.2:free",
    "messages": [{"role": "user", "content": "用一句话介绍你自己"}]
  }'

返回 JSON 里的 choices[0].message.content 就是模型的回答，usage.cost 字段会告诉你这次请求花了多少钱（免费模型为 0）。

方式二：Python（OpenAI SDK 改两行）

from openai import OpenAI

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",  # 只改这里
    api_key="sk-or-v1-你的Key",                 # 和这里
)

resp = client.chat.completions.create(
    model="z-ai/glm-5.2:free",  # 换模型名 = 换模型，其余代码不动
    messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(resp.choices[0].message.content)

任何语言的网络库都能调：接口就是标准的 HTTP POST，认证用 Bearer Token。

方式三：网页版 Request Builder（零代码）

打开官网的 Request Builder（openrouter.ai/request-builder），选模型、填参数、贴 Key，网页直接生成并预览请求代码，复制就能用。

换模型：只改 model 参数。模型名可以在 Models 页面 搜到，格式是 厂商/模型名（如 anthropic/claude-opus-4.8、deepseek/deepseek-v4-flash）。

第五步：接入常用工具

Claude Code 接 OpenRouter

OpenRouter 原生兼容 Anthropic Messages 协议（/api/v1/messages 端点），Claude Code 通过环境变量切换即可：

export ANTHROPIC_BASE_URL="https://openrouter.ai/api/v1"
export ANTHROPIC_AUTH_TOKEN="sk-or-v1-你的Key"

写进 ~/.zshrc 或 ~/.bashrc 后重启终端生效。这样 Claude Code 的模型调用就会走 OpenRouter 计费，还能切换到其他 Claude 系模型（模型 ID 用 anthropic/ 前缀）。

Cursor 接 OpenRouter

1. 打开 Settings → Models → API Key 设置
2. 选择 OpenAI API Key 类型，填入 sk-or-v1- Key
3. 把 Base URL 改为 https://openrouter.ai/api/v1
4. 在模型列表里添加你要用的 OpenRouter 模型名（如 deepseek/deepseek-v4-flash）

Cherry Studio / Chatbox 接 OpenRouter

这两款桌面客户端原生支持 OpenRouter：在设置的模型服务商里选择 OpenRouter，粘贴 API Key，模型列表会自动同步，无需手动填地址。

免费模型的两种用法

• 指定免费模型：模型名以 :free 结尾，如 z-ai/glm-5.2:free、minimax/minimax-m3:free
• 自动路由：模型名写 openrouter/free，平台自动从当前可用的免费模型里挑一个

常见报错排查

排查通用技巧：请求返回的 error 字段里有具体原因和供应商标记；官网 Activity 页可以看到每一次调用的模型、token 数和费用明细。

总结

完整链路回顾：注册（2 分钟）→ 支付宝充 $10（2 分钟，解锁每天 1000 次免费额度）→ 创建 Key（1 分钟）→ curl 或 Python 跑通（3 分钟）→ 按需接入 Claude Code / Cursor / Cherry Studio。整个过程不需要海外信用卡，也不需要改多少代码——OpenAI 兼容接口意味着你已有的代码几乎原样可用。

接下来建议：把一个真实小任务（比如周报总结、代码注释）迁到 OpenRouter 上跑一周，用 Activity 页的费用明细感受一下「按任务选模型」的成本差异——你会直观看到便宜模型和旗舰模型差了多少倍。模型怎么选、价格怎么算，看这篇：《OpenRouter 是什么？免费额度、价格与 400+ 模型调用全解》。

数据说明：本文流程于 2026 年 8 月 26 日实测（国内网络直连）；支付方式、手续费、免费额度规则核对自 OpenRouter 官方 FAQ 与定价页。如平台界面有改版，以 OpenRouter 官网 实际显示为准。

最后更新：2026 年 8 月