OpenRouter API Key 获取教程

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 表示额度用完了。
iPhone 上的 Oriveo 供应商页面,列出你已接入的供应商和本月花费。

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 网站上为准,打算依赖某个模型之前先去看一眼。
OpenRouter API 免费吗?
你的账户免费模型每分钟请求数免费模型每天请求数
累计购买不足 10 credits2050
累计购买至少 10 credits201,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」结尾的模型。
Oriveo 首页:输入框下方显示当前选中的模型,再往下是今天的对话,每段都标着花费
连上 Key 后,在输入框下方选模型。列表里每段对话都会显示预估费用。

我的 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 还在提供它。
OpenRouter API Key 用不了怎么办?
报错意思怎么办
401 Invalid credentialsKey 不对、已停用或已删除重新完整复制 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 并存,同一段对话里还能依次切换模型。

应用常见问题

OpenRouter 免费吗?
部分免费。Key 免费,ID 以「:free」结尾的模型在每日限额内不花钱:截至 2026 年 11 月 18 日,每天 50 次请求,累计购买至少 10 credits 后每天 1,000 次。其他模型需要预付额度。
OpenRouter API Key 怎么获取?
登录后在 openrouter.ai/keys 创建。新建 Key、起个名字,然后完整复制;它以「sk-or-v1-」开头。
OpenRouter 有 iPhone 或 Android App 吗?
OpenRouter 没有推出自己的手机聊天 App。可以用支持 OpenRouter Key 的聊天应用:在 Oriveo 里打开「供应商」,点「+」,选 OpenRouter,粘贴 Key,点「继续」。
OpenRouter 报错 402 是什么意思?
你的账户或正在用的这把 Key 额度不够了。到 OpenRouter 充值;如果给 Key 设过限额,就调高它,然后再试。它不会自己恢复。
OpenRouter API Key 为什么用不了?
先看错误码。401 表示 Key 不对,或者不是 OpenRouter 的 Key;402 表示没有额度;429 表示请求太多,或碰到了免费模型的限额。我们的 API Key 报错指南逐个解释了这些错误码。
OpenRouter API Key 长什么样?
以「sk-or-v1-」开头,后面跟 64 个字母和数字,一共 73 个字符。如果你的比这短,说明没复制全。

延伸阅读

来自博客

在手机上用你的 OpenRouter Key

打开网页版,或下载 iPhone、Android 版 Oriveo,粘贴你的 OpenRouter Key,在模型之间随时切换,每条回复都有预估费用。

还没有 API Key?可以先用 Oriveo Free 开始。