OpenRouter 是什么、怎么用？模型 API、费用、路由与隐私指南

直接答案：OpenRouter 不是大模型，而是连接应用与多家模型提供商的统一 API 和路由层。它适合需要快速接入多模型、集中查看用量、按规则选择提供商或设置故障回退的开发者；如果业务必须直接与单一厂商签约、严格限制数据链路，或者团队已经具备自建网关能力，则应先比较厂商直连和自建方案。

本文面向准备实际接入 OpenRouter 的中文开发者，回答五个问题：它解决什么问题、请求如何路由、费用怎么算、怎样完成第一次调用，以及隐私和生产上线前应检查什么。资料依据 OpenRouter 官方文档整理，复核日期为 2026 年 8 月 31 日；模型、价格、免费额度和提供商政策会变化，实际使用前应重新打开文中官方入口核对。

OpenRouter 是什么？

OpenRouter 提供一个统一入口，让应用使用近似 OpenAI Chat Completions 的请求方式调用不同模型。应用仍需在请求中选择模型，OpenRouter 再根据可用端点和你设置的提供商规则完成转发。它的价值主要在接口统一、模型与提供商路由、用量归集和故障回退，而不是替你判断哪个模型一定“最好”。

官方快速入门把接入方式分为直接 HTTP API、客户端 SDK 和 Agent SDK。模型目录既可以在网页中浏览，也可以通过 GET /api/v1/models 获取。由于模型 ID、上下文、输入输出模态、支持参数和价格可能调整，不要把旧文章里的模型清单永久写进代码，应把模型目录当作动态配置来源。参见 OpenRouter Quickstart 与 Models 文档。

如果你还在比较不同模型和服务方式，可以先阅读本站已经完成 A/B 实页验收的模型排行榜与选型方法和Together AI 模型 API 与部署选型指南。

一次 OpenRouter 请求是怎样完成的？

1. 应用提交请求：发送 API Key、模型 ID、messages 以及所需参数。
2. 验证身份和限额：平台检查密钥、余额、速率限制或密钥预算。
3. 核对能力：模型和候选端点是否支持工具调用、结构化输出或其他参数。
4. 应用策略：根据提供商顺序、是否允许回退、数据收集和 ZDR 等条件过滤端点。
5. 调用上游：实际模型提供商处理请求并返回响应或错误。
6. 记录用量：响应中返回模型、Token 和费用等信息，Activity 页面可以按模型、API Key 等维度查看汇总。

默认路由并不等于“自动替你挑选最聪明的模型”。当你指定一个模型时，OpenRouter 主要在该模型可用的提供商端点之间选择；如果希望主模型失败后尝试另一模型，需要显式使用模型 fallback。官方说明列出的触发情况包括限流、服务不可用、上下文校验错误和部分内容审核拒绝。参见Provider Routing和Model Fallbacks。

怎样完成第一次 API 调用？

第一步：创建独立项目密钥

注册后在控制台创建 API Key。不同环境使用不同密钥，例如开发、预发布和生产各一把；不要把密钥写进前端 JavaScript、公开仓库、截图或日志。生产环境应通过服务端环境变量或密钥管理服务注入，并为密钥设置预算或使用限制。

第二步：从当前模型目录选择模型 ID

打开 OpenRouter Models，根据输入输出模态、上下文、参数支持、价格和近期端点表现筛选。也可以请求模型 API：

curl "https://openrouter.ai/api/v1/models" \
  -H "Authorization: Bearer $OPENROUTER_API_KEY"

不要只看模型名称。生产选型至少记录：完整模型 ID、所需参数、输入输出类型、上下文限制、价格单位、可用提供商、数据政策和复核日期。

第三步：发送最小请求

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key=os.environ["OPENROUTER_API_KEY"],
)

response = client.chat.completions.create(
    model="<从当前模型目录复制完整 MODEL_ID>",
    messages=[
        {"role": "user", "content": "用三句话解释什么是模型路由。"}
    ],
)

print(response.choices[0].message.content)

示例故意不写死某个模型，因为可用型号和别名会变化。先从官方模型页复制当前 ID，再运行代码。若返回 401，优先检查密钥是否传入；返回 402 通常与余额或支付有关；返回 429 时应查看当前模型、提供商和账户的限流信息，并使用指数退避，不要无上限重试。

第四步：记录真实使用模型与费用

保存响应里的模型、usage 和费用字段，并在 Activity 页面按模型、API Key 或成员检查请求量和支出。对于会自动回退的请求，最终计费取决于实际成功使用的模型，不能只按请求中的首选模型估算。官方 Activity Export 文档说明可导出 Spend、Tokens 和 Requests 汇总。

提供商路由与模型回退怎么配置？

这两个概念经常被混淆：

• 提供商路由：同一个模型可能由多个端点提供。你可以设置提供商顺序、是否允许其他端点回退、是否要求端点支持全部参数，以及数据策略。
• 模型回退：首选模型失败后，再尝试另一模型。不同模型输出质量、工具调用格式和费用可能不同，必须在业务层验证结果是否仍满足要求。

{
  "model": "<MODEL_ID>",
  "messages": [{"role": "user", "content": "..."}],
  "provider": {
    "allow_fallbacks": true,
    "require_parameters": true,
    "data_collection": "deny",
    "zdr": true
  }
}

require_parameters 可以把不支持所需参数的端点排除；data_collection: "deny" 和 zdr: true 则属于数据策略过滤。过滤条件越严格，可用端点可能越少，因此上线前要测试“合规条件满足但没有可用端点”的失败路径。

费用、免费模型和 BYOK 应该怎样理解？

OpenRouter 使用美元 Credits 结算，并在模型页展示不同模型和提供商的计价单位。费用不是一个固定的“OpenRouter 每次调用价格”，而由实际模型、输入输出 Token、图像、请求或其他计价项决定。

截至 2026 年 8 月 31 日，官方 FAQ 写明：购买 Credits 会收取平台费用，免费模型有较低速率限制，不适合直接假设为生产容量；BYOK（自带上游密钥）前一百万次月请求免平台费，超过后按对应模型/提供商正常成本的一定比例收费。这些数字属于高变化信息，本文不建议据此长期预算，付款前必须重新查看官方 FAQ和结算页面。

隐私与数据保留：ZDR 不等于所有风险自动消失

一次请求至少涉及你的应用、OpenRouter 和实际处理请求的上游端点。判断隐私风险时要分别确认每一层，而不能只看到“加密传输”或“不开启训练”就结束审查。

OpenRouter 的 ZDR（Zero Data Retention）策略可以把请求限制到不保留数据的端点，并支持在账户、模型组、guardrail 或单次请求层面执行。官方同时提醒：某个提供商的一般政策可能与具体端点政策不同；“不用于训练”和“完全不保留”也是两件不同的事。参见Zero Data Retention和Provider Logging。

• 发送前删除不必要的姓名、联系方式、身份证件、内部密钥和客户原文。
• 在模型/端点页核对训练、保留、地区和合规条款，并记录复核日期。
• 高敏感业务先让法务、安全和采购确认合同关系，不要把 ZDR 参数当作合同替代品。
• 对组织账户设置模型 allowlist、预算和隐私 guardrail，并测试规则被拒绝时的用户提示。

涉及个人或企业资料时，可继续阅读本站的AI 隐私泄露与误传补救指南和AI 项目隐私技术选型指南。

OpenRouter 适合谁，不适合谁？

更适合 OpenRouter 的情况

• 需要用相同业务代码比较多个模型，减少重复适配。
• 需要在模型或提供商故障时配置受控回退。
• 原型团队希望先验证任务效果，再决定长期直签或自建方案。
• 需要集中观察跨模型的请求、Token 和费用。

应优先考虑直连或自建网关的情况

• 合同要求数据只能发送给指定厂商或指定地区端点。
• 只使用一个厂商，并依赖其专属支持、批量任务或平台特性。
• 需要完全控制日志、鉴权、审计、流量策略和私有网络链路。
• 团队已经拥有成熟的平台工程能力，能持续维护多模型适配和故障处理。

如果准备把模型调用扩展为可执行任务的智能体，还应补充权限、工具调用和回滚设计，可参考AI Agent 上线治理指南。

生产上线检查清单

1. 锁定意图：明确任务是对话、结构化输出、工具调用、图像还是嵌入，不按热度盲选模型。
2. 锁定版本：记录完整模型 ID、复核日期和迁移方案；谨慎使用会自动变化的 latest 别名。
3. 验证参数：确认候选端点支持全部必需参数，测试不兼容时的返回。
4. 限制费用：为每把 Key 设置预算，记录单请求上限，防止循环调用。
5. 定义回退：明确哪些错误可重试、最多尝试几次、备用模型输出是否可接受。
6. 落实隐私：数据最小化，设置训练/保留策略，逐端点核对地区与条款。
7. 保存观测字段：模型、提供商、Token、费用、延迟、错误和回退次数进入日志，但不记录密钥和不必要的用户原文。
8. 做退出演练：验证余额不足、429、上游故障、策略无可用端点和平台不可达时，应用能安全降级。

常见问题

OpenRouter 是免费的模型平台吗？

不是。它提供部分免费模型或免费路由，但限流和可用性与付费端点不同。生产项目应按官方当前限额和实际压力测试做容量设计。

接入 OpenRouter 后就不需要理解上游模型了吗？

仍然需要。统一接口减少适配工作，但上下文、工具调用、输出结构、隐私、价格和质量仍由具体模型与端点决定。

OpenRouter 会自动选择最好的模型吗？

不能这样概括。你可以使用路由器或配置回退，但“最好”取决于任务、成本、延迟、质量和风险。关键任务应建立自己的评测集。

使用 ZDR 后能发送客户隐私数据吗？

ZDR 是重要控制，但不是单独的放行条件。仍需进行数据最小化、端点政策核对、合同与地区审查，并确认应用自身日志不会保存敏感内容。

本次复核与纠错记录

本文于 2026 年 8 月 31 日按新版编辑流程重建。旧稿包含无法由所列来源证明的模型调用量、排名、价格优势、企业案例和未来趋势，还引用了无法核验的社交媒体、博客与研究链接；本次已删除这些断言，改为依据 OpenRouter 官方快速入门、模型目录、路由、fallback、FAQ、BYOK、ZDR 和提供商数据政策说明。站内同意图页面 107450 与草稿 104802 不再作为独立升级目标，待主页面完成实页验收后进入合并与重定向复核。

官方资料

• OpenRouter Quickstart
• Models
• Provider Routing
• Model Fallbacks
• FAQ：费用、免费模型与限流
• BYOK
• Zero Data Retention
• Provider Logging