OpenRouter 怎么用：一个接口调用多家大模型，充值、免费模型限额与 401、402、429 报错全解

OpenRouter 是一个模型聚合平台：你只需要一个密钥、一个接口地址，就能调用来自不同厂商与不同推理服务商的几百个模型。它的请求格式与 OpenAI 的聊天补全接口兼容，原来用官方 SDK 写的代码，把基础地址换成 https://openrouter.ai/api/v1、密钥换成以 sk-or 开头的 OpenRouter 密钥、模型名换成「厂商/模型」的写法，基本就能直接跑。对需要横向比较模型、或者不想在每家都单独开户的开发者，这是最省事的方案。

但从国内用起来会遇到几类问题：网页控制台和接口时快时慢，长回复经常在中途断开；充值时付款被拒；免费模型调几次就返回 429；明明余额充足却报 402 或者 403。这些问题分别出在网络、支付、限额和上游路由四个层面。下面先讲清平台的结构，再给出接入步骤与报错表。价格、限额与支持的支付方式会调整，以官方最新条款为准。

OpenRouter 与直连厂商接口的区别

选择 OpenRouter 的理由主要是省去多家开户和统一格式；代价是多了一层中转，个别模型的新功能上线会比官方晚一点，充值也有手续费。对已经确定只用一家模型、调用量很大的生产环境，直连官方接口通常更划算；对处在选型阶段、需要频繁对比的项目，聚合接口能省下大量对接时间。

从注册到跑通：分步操作步骤

• 第一步：先把网络线路准备好，连上刺猬VPN 后再打开 openrouter.ai。安装客户端后自定义用户名和密码即可匿名注册，不需要邮箱、也不需要手机号，免费节点永久免费、不限流量，适合先测试控制台和接口能否连上；全程 HTTPS+AES 加密传输；
• 第二步：注册 OpenRouter 账号。可以用邮箱或第三方账号登录，注册后进入右上角菜单里的「Keys」页面，点「Create Key」生成密钥，密钥只显示一次，立即保存到本地的环境变量里，不要写进代码仓库；
• 第三步：给密钥设额度上限。创建时可以填写 Credit limit，给测试用的密钥设一个小额上限，即使泄露也不会被刷光余额；
• 第四步：先用免费模型验证连通。模型名后缀带「:free」的是免费版本，用 curl 向 https://openrouter.ai/api/v1/chat/completions 发一个 POST 请求，请求头带 Authorization: Bearer 你的密钥，请求体写 model 和 messages 两个字段，能返回 choices 就说明链路通了；
• 第五步：需要付费模型时充值。在「Credits」页面选择金额，支付方式以页面实际显示为准，通常有银行卡和加密货币等选项；国内发行的卡可能被拒，换卡或改用其他方式；
• 第六步：把现有代码切过来。OpenAI 官方 Python SDK 里把 base_url 设为 https://openrouter.ai/api/v1、api_key 设为 OpenRouter 密钥，模型名写成 openai/gpt-4o、anthropic/claude-3.5-sonnet 这样的格式。可选地在请求头加 HTTP-Referer 和 X-Title，用于在平台排行榜上标注你的应用；
• 第七步：开启流式输出。长回复用 stream: true 逐段返回，可以避免长时间无响应被中间网络设备断开，用户体验也更好；
• 第八步：配置备用模型。请求体里可以用 models 数组列出多个模型，第一个不可用时自动切到下一个；也可以用 provider 字段指定首选的推理服务商与是否允许回退，生产环境建议都设上。

按现象排查：网络、额度与路由

OpenRouter 的报错码有明确含义，先看状态码判断属于哪一层，再对症处理，不要一律重试。

• 连接超时或 SSL 握手失败：网络层问题，确认线路已连上，换一个延迟更低的节点；服务器上调用的，要确认服务器进程本身走了线路；
• 返回 401：密钥无效或被删除，检查请求头的 Bearer 后面是否多了空格、换行，或者用错了其他平台的密钥；
• 返回 402：余额不足，或者这把密钥设置的额度上限已经用完，充值或在「Keys」页面调高上限；
• 免费模型返回 429：触发了免费版本的速率或每日次数限制，等一段时间再试，或者改用付费版本，具体限额以官方说明为准；
• 返回 403：输入内容被审核拦截，或者所选模型的上游服务商不支持你的请求，检查提示词，或换一个模型；
• 返回 502 或 503：上游服务商暂时不可用，或没有符合你路由条件的服务商，配置 models 备用列表或放宽 provider 限制；
• 流式输出中途断开：长连接被中间网络打断，换稳定的节点，并在代码里对未完成的流做重试；
• 费用比预期高：长上下文和推理模型的输出计费较贵，在「Activity」页面查看每次调用的 token 数与费用明细。

线路与调用方式对比

接口调用本身流量很小，一次几千 token 的对话只有几十 KB，真正要紧的是长连接不要断。本地开发调试用免费节点就能验证；每天长时间调试、跑批量评测的话，时长套餐更稳定，有效期内不限流量、不限速。正式上线的服务建议直接部署在海外服务器上，不依赖本地网络。智能分流按域名与 IP 区分流量，访问国内的数据库和接口不受影响。实际可用性取决于当前网络环境。

控制费用的几个习惯

聚合平台最容易让人失去成本感，因为切换模型太方便了。几个习惯能把费用控制住：每个项目单独建一把密钥并设额度上限，出问题时能立刻定位是哪个项目在烧钱；评测阶段先用免费或便宜的小模型跑通流程，确认提示词稳定后再换大模型；在「Activity」页面定期看各模型的花费占比，发现某个模型的输出 token 异常多，往往是提示词没有约束长度。

另外要注意推理类模型的计费方式。这类模型会先生成一段思考过程再给出答案，思考部分同样按输出 token 计费，同样的问题花费可能是普通模型的数倍。对不需要深度推理的任务，比如格式转换、摘要、分类，用普通模型就够了。

团队共用时，建议由一个人统一充值，再给每位成员单独生成密钥并设额度上限，离职或项目结束时删掉对应密钥即可，不用改其他人的配置。密钥不要放进前端代码或移动端安装包里，任何能拿到安装包的人都能把它提取出来；正确的做法是让请求经过你自己的后端服务转发，密钥只存在服务器的环境变量中。

与其他模型接口的分工

OpenRouter 的价值在于统一和切换，但如果你主要只用 OpenAI 的模型，直接用官方接口能第一时间拿到新功能，组织管理、用量导出也更完整，注册、充值与地区限制的处理见 OpenAI API 开发者接入指南。很多团队的做法是：主力模型直连官方，其他模型通过 OpenRouter 补充。

追求低延迟推理的场景，比如实时对话、语音助手，可以看专门做推理加速的平台，它们在开源模型上的首字延迟往往更低，对比与接入方法见 Groq 与 Together AI 接口指南。值得一提的是，这些推理平台本身也是 OpenRouter 的上游服务商之一，可以先在 OpenRouter 里用 provider 字段指定它们试用，确认效果后再决定是否单独开户。

常见报错速查表

高频问答

• 问：OpenRouter 的价格比官方贵吗？答：模型单价通常与上游一致，充值时另有手续费，以官方最新条款为准；
• 问：免费模型能用于正式项目吗？答：免费版本有速率和次数限制，部分还会被上游用于改进服务，不适合正式项目；
• 问：原来的 OpenAI SDK 代码要大改吗？答：不用，改基础地址、密钥和模型名三处即可；
• 问：为什么同一个模型两次回复风格不一样？答：可能被路由到了不同的上游服务商，量化与参数不同，用 provider 字段固定服务商；
• 问：调用要不要一直开着线路？答：本地调试需要线路可达，正式服务建议部署在海外服务器，不依赖本地网络；
• 问：密钥泄露了怎么办？答：立即在「Keys」页面删除并重建，平时给每把密钥设额度上限。

把 OpenRouter 用得稳当

OpenRouter 模型聚合接口的常见问题，拆开看都很清楚：连不上靠线路，401 看密钥格式，402 看余额与密钥上限，429 是免费限额，502 与 503 靠备用模型与服务商回退。再加上流式输出和额度上限两个习惯，基本就能稳定使用。

刺猬VPN 采用 HTTPS+AES 加密传输，支持自定义用户名和密码匿名注册，不需要邮箱和手机号；免费节点永久免费、不限流量、不限速，适合先测试接口能否连上；时长套餐有效期内不限流量、不限速，适合每天长时间调试的开发者，一个账号支持多设备同时在线。客户端带断线保护（Kill Switch）与按域名和 IP 的智能分流，线路中断时拦住流量，国内服务保持直连。平台价格与限额以官方最新条款为准，实际可用性取决于当前网络环境。