OpenRouter Auto Router 并不会自动免费。 openrouter/auto 本身不额外收取 Router 使用费,但用户要按它实际选择的模型支付标准费用。真正只在当前免费模型中选择的是 openrouter/free。
还有第三种方式:直接选择 slug 以 :free 结尾的具体模型 variant。它比 Free Models Router 更能固定模型,但仍然受免费推理的可用性和 rate limit 限制。
名称很接近,解决的决策却不同:
OpenRouter 在这里属于模型与 Provider 访问层,不是负责读取仓库、执行工具和验证改动的 Coding Agent harness。如果这些层级容易混淆,可以先看模型与 Agent harness 的区别。
OpenRouter Auto Router 是什么?
官方 Auto Router 文档把 openrouter/auto 定义为一个会为 Prompt 自动选择模型的 slug。OpenRouter 表示,选择会参考不同任务类型过去 7 天的市场使用情况,以及 Router 当前的成本档位和资格限制。
所以,Auto Router 本质上是一个模型选择器。当应用收到的 Prompt 类型差异很大、一个固定模型不适合全部请求时,它可能有用。
响应里会返回最终选择的模型。这个字段应该进入日志,否则应用只看到价格或行为发生变化,却不知道底层模型已经换了。
Auto Router 还支持通过 allowed_models 和 excluded_models 限制候选。工作流存在合规要求、固定评测集,或者只允许通过内部验收的模型时,这些控制很重要。
Auto Router 怎么收费?
OpenRouter 当前文档表示,使用 Auto Router 不额外收费;请求按真正提供服务的模型标准费率结算。
“没有额外 Router fee”不等于“推理免费”。如果 Router 选中付费模型,请求就会按该模型当前价格消耗 credits。不同 Prompt 可能选中不同模型,因此成本也可能变化。
当前 Auto Router 使用 cost_tier 控制成本带,分为 low、medium、high、xhigh 和 max。官方说明,low 偏向价格更低但满足任务要求的模型,max 偏向能力更强的模型,不以价格为主要限制;没有设置时,大致按 low band 路由。
Cost tier 不是硬性的最高单价。官方把它描述为市场价格带,可能同时排除低于和高于该区间的模型。如果业务需要严格预算上限,不能把 cost_tier 当作 cap;还应在应用层限制预算,并监控返回的模型和 usage。
旧示例里可能出现 cost_quality_tradeoff。OpenRouter 现在把这个字段标记为 deprecated,只为兼容继续接受;如果两个参数同时存在,以 cost_tier 为准。新实现应使用当前文档,而不是复制旧代码片段。
Free Models Router 是什么?
Free Models Router 使用 openrouter/free,只在请求发生时仍然可用的免费模型中选择。
OpenRouter 说明,它会先根据请求所需能力过滤,例如图片理解、Tool Calling 或 Structured Output,再从合格的免费池中随机选择。也就是说,它不是无条件把请求随机丢给任意模型,但最终模型仍然可能变化。
通过 API 调用时,可以这样设置:
响应会标出真正处理请求的模型。评估输出质量或排查回归时,一定要把这个值保存在日志里。
:free 模型 variant 是什么?
OpenRouter 还为部分具体模型提供 Free Variant。在合格模型 slug 后添加 :free,就能请求该模型的免费 variant,而不是让 openrouter/free 从池子中选择。
如果你想反复评估一个已知模型,这是更可控的免费方式,但它不会把免费 endpoint 变成付费容量。其 rate limit 和 availability 仍可能不同于付费版本。
三种方式适合不同任务:
- 当模型可以变化,并愿意支付被选模型的价格时,用
openrouter/auto。 - 当零模型推理费比固定模型更重要时,用
openrouter/free。 - 当你想固定一个免费模型,并能接受免费 endpoint 限制时,用
model-slug:free。
当前免费模型有什么限制?
免费模型规则变化很快。截至 2026 年 8 月 27 日,OpenRouter 的 FAQ 和 Pricing 页面显示,基础免费模型 API 限额通常为每天 50 次;FAQ 当时显示,购买至少 10 美元 credits 的账号,免费模型限额提高到每天 1,000 次。
这些数字只是带日期的快照,不是永久额度。任何依赖它们的实现都应重新检查当前账号页面和官方文档。
Free Models Router 指南还明确提示,免费模型的 rate limits 和 availability 可能与付费模型不同。官方把它们定位在实验、学习和低流量用途,对可靠性要求更高的生产工作负载则建议考虑付费模型。
实际限制包括:
- 免费模型池会变化;
openrouter/free可能在不同请求中选择不同模型;- 请求的必要能力会缩小合格模型池;
- 免费 endpoint 可能被限流或暂时不可用;
- 模型变化也会带来行为、上下文、tokenizer 和工具可靠性的变化。
这里的“免费”只描述合格免费路线的模型推理成本,不保证容量、固定模型、SLA 或整个应用零成本。自己的服务器、工具、搜索、存储和人工审核仍可能产生费用。
Coding 任务该选 Auto Router 还是 Free Router?
Coding 工作流通常会为一个任务发出多次请求和工具调用,所以两者差别会被放大。
学习与 Prompt 实验
结果不涉及生产时,openrouter/free 适合熟悉 API、测试小 Prompt,或者观察不同模型的输出差异。需要记录实际模型,否则实验无法解释。
重复评估一个模型
具体 :free variant 比 Free Models Router 更适合干净比较,因为模型身份固定。但 availability 和 rate limits 仍会中断测试,不能把它当成生产容量验证。
混合的通用 Prompt
当任务类型多样,并且应用接受 Router 自动选择模型时,openrouter/auto 可能有用。应把候选限制在通过最低验收的模型内,选择合适的 cost tier,并记录每次请求的实际模型。
需要可复现的生产 Agent
固定付费模型,或带明确 Fallback 的严格模型清单,通常更容易排错、审计和归因成本。它并非在所有情况下都更好,只是去掉了一个变化来源。生产可靠性还会受到 Provider routing 影响,具体可以看 OpenRouter 如何选择 Provider。
如何避免意外费用和行为漂移?
把 Router 接入多步骤 Coding 循环前,至少加入这些控制:
- 记录实际模型。 Auto 和 Free Router 都会在响应中返回服务模型。
- 记录 usage 和整个任务成本。 包括重试,不只看单次请求。
- 限制候选模型。 只有通过评测的模型才能进入 Auto Router allowlist。
- 设置应用预算。 Cost tier 是选择提示,不是硬支出上限。
- 核对必要能力。 Tools、Structured Output、输入模态和上下文必须匹配。
- 定义失败处理。 明确是重试、换 Provider、换模型,还是停止并要求审核。
- 运行验收任务。 使用相同仓库状态、工具与验收命令比较结果。
如果第一步是决定哪些固定模型值得测试,可以先按实时价格比较 OpenRouter 编程模型,再开启自动选择。
OpenRouter Router 不能代替 Agent harness
Auto Router 选择模型,Free Models Router 选择免费模型,Provider routing 选择能够提供该模型的 endpoint。这些动作都不会单独完成完整 Coding Agent 循环。
Agent harness 仍然负责仓库访问、工具执行、session 状态、审批、上下文压缩、重试和验证。Router 可以成为系统的一层,但不能把属于 harness 的能力算到 Router 上,也不能把其他工具或环境造成的失败全归因于模型路由。
把层级分清还能改善测量:记录模型、Provider、harness 版本、工具错误、任务结果和成本。否则任何一层变化都会看起来像无法解释的模型漂移。
常见问题
openrouter/auto 可以免费调用吗?
Router 没有单独使用费,但它选择的模型可能收费,请求按被选模型的标准价格结算。
哪个 OpenRouter Router 只使用免费模型?
openrouter/free 只从当前可用的免费模型中选择;部分具体模型也能通过 :free variant 请求。
Free Models Router 每次都会返回同一个模型吗?
不会。OpenRouter 表示,它先按照请求所需能力筛选当前免费池,再从中选择模型。如果一致性重要,必须记录返回的模型。
OpenRouter 免费模型可以用于生产吗?
官方指南把它们定位为实验、学习和低流量用途,并提示其 rate limits 和 availability 不同于付费模型。生产决策应该由容量、可靠性要求和自己的验收测试决定。
Auto Router 永远是最便宜的吗?
不是。当前 cost tier 会影响市场价格带,但 Router 的任务是为请求选择合适模型。它可能选择付费模型,low 也不是硬性最高单价。
结论
OpenRouter Auto Router 不是免费模型路由。需要自动选模并愿意接受被选模型价格时使用 openrouter/auto;需要低流量、零模型费实验时使用 openrouter/free;想固定免费模型时使用具体 :free variant。
在把任何选项接入 Coding Agent 循环前,记录实际模型、强制预算、限制候选范围,并运行一个可复现的验收任务。这样,“免费还是自动”才会从名称问题变成可测量的运行决策。
