OpenRouter API Key 怎么获取?免费模型怎么用
创建 OpenRouter API Key,看懂免费模型的限额,解决 401、402、429 报错,在 iPhone、Android 或网页上用 OpenRouter。
- 获取 OpenRouter API Key:登录 openrouter.ai,打开 openrouter.ai/keys 创建一个 Key,它以「sk-or-v1-」开头。创建 Key 免费;ID 以「:free」结尾的模型可以在每日限额内免费用,其他模型都从预付额度(credits)里扣费。
- OpenRouter 让你用一个账号、一把 Key,调用很多家 AI 公司的模型。它没有推出自己的 iPhone 或 Android 聊天 App,所以在手机上要用一款支持 OpenRouter Key 的聊天应用,比如 Oriveo。
- 截至 2026 年 11 月 18 日,免费模型每分钟 20 次请求、每天 50 次;累计购买至少 10 credits 后,每天 1,000 次。报错 402 表示额度用完了。

OpenRouter 是什么?API Key 又是什么?
OpenRouter 是一项服务,用一个账号就能用到很多家 AI 公司的模型。不用挨家注册,只要在 OpenRouter 充一次额度,再从它的列表里挑模型。
API Key 是应用用你的账号发请求时带上的密钥。OpenRouter 校验 Key,把你的消息发给你选的模型,再从你的 OpenRouter 额度里扣费。
OpenRouter 是为应用和开发者做的,没有推出自己的 iPhone 或 Android 聊天 App,所以很多人会去搜「OpenRouter App」。其实大家需要的,是一款支持 OpenRouter Key 的聊天应用。
OpenRouter API Key 怎么获取?
在 OpenRouter 网站上操作,两三分钟就好。
- 打开 openrouter.ai,注册或登录。
- 进入 Key 页面 openrouter.ai/keys,新建一个 Key,按要用的应用或设备命名。
- 复制 Key。OpenRouter 的 Key 以「sk-or-v1-」开头,一共 73 个字符,确认整串都复制全了。
- 想用非免费的模型,就到 Credits 页面充值额度。
- 把 Key 存在安全的地方,比如密码管理器。万一泄露,到 Key 页面删掉,再建个新的。
OpenRouter API 免费吗?
部分免费。注册账号、创建 Key 都不花钱,OpenRouter 还提供 ID 以「:free」结尾的免费模型;其他模型都从预付额度里扣。OpenRouter 也说新用户会拿到少量免费额度,但没说具体多少。
免费模型有限额。以下是截至 2026 年 11 月 18 日 OpenRouter 公布的限额:
- OpenRouter 说,账户余额一旦低于零,连免费模型也可能报错。
- 哪些模型目前有「:free」版本,以 OpenRouter 网站上为准,打算依赖某个模型之前先去看一眼。
| 你的账户 | 免费模型每分钟请求数 | 免费模型每天请求数 |
|---|---|---|
| 累计购买不足 10 credits | 20 | 50 |
| 累计购买至少 10 credits | 20 | 1,000 |
OpenRouter 的额度(credits)怎么充、怎么扣?
OpenRouter 是预付费的。你在 Credits 页面用银行卡或页面上列出的其他支付方式买额度,每次请求从里面扣。截至 2026 年 11 月 18 日,OpenRouter 的条款规定每次至少购买 5 美元,会另收支付手续费,并写明未用完的额度可能在购买 365 天后过期。最新细则见 openrouter.ai/terms。
每个模型都有自己的 token 单价,写在 OpenRouter 上该模型的页面里。价格会变,所以这里不抄。Oriveo 会在每条回复上显示预估费用;最终以 OpenRouter 的 Activity 和账单页面为准。
怎么在 iPhone、Android 或网页上用 OpenRouter?
OpenRouter 没有官方手机 App,所以要选一款客户端应用。在 Oriveo 里,OpenRouter 是 15 家内置供应商之一,在「聚合平台」分类下,不用自己填地址。
- 打开「供应商」:iPhone 和 Android 在底部标签栏,网页版在侧边栏。
- 点「+」按钮(添加供应商),选择 OpenRouter。点「聚合平台」可以缩小列表。
- 在「连接 OpenRouter」下粘贴 Key,点「继续」。
- 等「正在验证连接并同步模型...」完成,Oriveo 会载入 OpenRouter 的模型列表。
- 选一个模型开聊。还没充值的话,就选 ID 以「:free」结尾的模型。

我的 OpenRouter Key 会去哪?
在 iPhone 和 Android 上,请求从你的设备直接发给供应商,Key 存在手机的安全存储里(iPhone 用 Keychain,Android 用 Keystore)。网页版的请求经 Oriveo 服务器实时转发:Key 只用于这一次请求,不会存成账号记录,BYOK(自带 Key)对话也不会存成聊天日志。云同步不会上传 Key。想在第二台设备上用 OpenRouter,就在那台设备上也粘贴一次,或者单独给它建一个 Key。
你按 OpenRouter 的价格直接付钱给 OpenRouter,Oriveo 不加价。
OpenRouter API Key 用不了怎么办?
OpenRouter 的错误页面(openrouter.ai/docs/api-reference/errors)列出了每个错误码的含义。截至 2026 年 11 月 18 日,常见的有这些:
- 在 Oriveo 里,402 显示为「供应商额度已用完」;429 在网页版显示为「频率限制」,在 iPhone 和 Android 上显示为「供应商请求频率受限」。
- 列表里少了某个模型:重新同步模型列表,并确认 OpenRouter 还在提供它。
| 报错 | 意思 | 怎么办 |
|---|---|---|
| 401 Invalid credentials | Key 不对、已停用或已删除 | 重新完整复制 Key,或者新建一个 |
| 401「this is not an OpenRouter API key」 | 粘贴成了别家供应商的 Key | 用 openrouter.ai/keys 里的 Key,它以 sk-or-v1- 开头 |
| 402 insufficient credits | 账户或这把 Key 的额度用完了 | 充值额度,或调高这把 Key 的限额;干等没用 |
| 403 Forbidden | 被权限、内容审核、防护规则(guardrail)或预算上限拦下了 | 检查这把 Key 的设置和限额,或者改一下消息内容 |
| 429 rate limited | 请求太多:OpenRouter 本身或模型背后的供应商在限流 | 等一会儿再试;用免费模型的话,对照上面的限额 |
| 502 或 503 | 模型或它背后的供应商暂时不可用 | 稍后再试,或换个模型 |
用 OpenRouter,还是每家单独一把 Key?
想用一把 Key、一份余额覆盖很多模型,OpenRouter 很方便。想要某家供应商自己的账号和账单,就直接去 OpenAI、Anthropic 这类供应商拿 Key。Oriveo 两种都支持,OpenRouter 可以和直连 Key 并存,同一段对话里还能依次切换模型。