Agent.Space 博客

OpenRouter Auto Router 免费吗?Auto、Free Router、费用与限制

OpenRouter Auto Router 并不自动免费。本文对比 openrouter/auto、openrouter/free、:free 模型、费用、额度和适用场景。

OpenRouter Auto Router 并不会自动免费。 openrouter/auto 本身不额外收取 Router 使用费,但用户要按它实际选择的模型支付标准费用。真正只在当前免费模型中选择的是 openrouter/free

还有第三种方式:直接选择 slug 以 :free 结尾的具体模型 variant。它比 Free Models Router 更能固定模型,但仍然受免费推理的可用性和 rate limit 限制。

名称很接近,解决的决策却不同:

选择如何选择模型模型推理费用主要取舍
openrouter/autoAuto Router 为 Prompt 选择合格模型按被选模型的标准价格付费模型和成本可能随请求变化
openrouter/freeFree Models Router 从当前免费模型中选择免费路线不收模型推理费限额更低、可用性变化、模型更难预测
model-slug:free用户选择一个具体免费模型 variant该免费 variant 不收模型推理费免费 endpoint 可能限流或不可用
固定付费模型用户固定模型按实际路线的公开价格付费模型身份更稳定,但不免费

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_modelsexcluded_models 限制候选。工作流存在合规要求、固定评测集,或者只允许通过内部验收的模型时,这些控制很重要。

Auto Router 怎么收费?

OpenRouter 当前文档表示,使用 Auto Router 不额外收费;请求按真正提供服务的模型标准费率结算。

“没有额外 Router fee”不等于“推理免费”。如果 Router 选中付费模型,请求就会按该模型当前价格消耗 credits。不同 Prompt 可能选中不同模型,因此成本也可能变化。

当前 Auto Router 使用 cost_tier 控制成本带,分为 lowmediumhighxhighmax。官方说明,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 调用时,可以这样设置:

json
{  "model": "openrouter/free",  "messages": [{ "role": "user", "content": "Explain this failing test." }]}

响应会标出真正处理请求的模型。评估输出质量或排查回归时,一定要把这个值保存在日志里。

: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 的 FAQPricing 页面显示,基础免费模型 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 循环前,至少加入这些控制:

  1. 记录实际模型。 Auto 和 Free Router 都会在响应中返回服务模型。
  2. 记录 usage 和整个任务成本。 包括重试,不只看单次请求。
  3. 限制候选模型。 只有通过评测的模型才能进入 Auto Router allowlist。
  4. 设置应用预算。 Cost tier 是选择提示,不是硬支出上限。
  5. 核对必要能力。 Tools、Structured Output、输入模态和上下文必须匹配。
  6. 定义失败处理。 明确是重试、换 Provider、换模型,还是停止并要求审核。
  7. 运行验收任务。 使用相同仓库状态、工具与验收命令比较结果。

如果第一步是决定哪些固定模型值得测试,可以先按实时价格比较 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 循环前,记录实际模型、强制预算、限制候选范围,并运行一个可复现的验收任务。这样,“免费还是自动”才会从名称问题变成可测量的运行决策。