01 / FIND
免费模型在哪里找？
从 OpenRouter 官方免费模型合集进入，再打开具体模型详情。核对完整模型 ID、输入输出价格、支持的能力与当前提供商，不要只凭合集名称或旧截图判断免费。
- 先确定用途：简单文本、图片理解、工具调用或结构化输出。
- 检查具体条目是否满足所需能力，并核对输入和输出单价。
- 复制模型页显示的完整 ID，到客户端的模型设置中填写；账户、密钥与 Base URL 的配置见 接入教程。
02 / CHOOSE
:free 和 openrouter/free 有什么区别？
| 方式 | 含义与使用边界 |
|---|---|
| 指定免费变体 | 厂商/具体模型:free 是格式示意，不是可直接调用的 ID。必须从官方目录复制实际存在的免费变体，不能给任意付费型号加上 :free 就变成免费。 |
| 免费路由 | openrouter/free 会从当前可用免费模型中，按请求所需能力筛选后随机选择；并不保证每次选中同一个模型。具体规则见 官方路由页。 |
想比较同一模型的表现：使用确切的免费模型 ID，并记录响应中的模型及提供商信息。免费路由更适合接受模型变化的探索性体验，不适合把多次结果当成同一模型的稳定基准。
免费路由当前的文本输入、输出 token 标价为零。真实使用仍要核对当前模型条目、额外功能与账户状态；不要将其他平台的收费规则套用到 OpenRouter。
03 / LIMITS
免费额度怎么看，为什么会用完？
请求次数限制与消费金额上限是两种不同的限制。免费模型可能受每分钟、每日请求数量和上游容量约束；具体阈值按账户条件和官方规则变化。
开发者可以在自己的安全环境中，通过带 Bearer 鉴权的 GET https://openrouter.ai/api/v1/key 查询当前密钥信息。不要把真实密钥粘贴到本站或陌生在线测试工具中。字段定义与请求示例以 官方 Limits 文档为准。
| 字段 | 应该怎么看 |
|---|---|
free_model_daily_requests | 当前 UTC 日的免费模型请求使用情况，包括已用、上限与剩余次数；UTC 日期边界不等于北京时间零点。 |
limit_remaining | 密钥剩余的消费额度，不是剩余免费请求次数；应连同消费上限、账户余额和其他响应字段理解。 |
账户负余额也可能影响免费模型。更换或增加 API Key 不是扩大账户平台限额的方法。付费模型的成本另见 价格计算与费用估算。
04 / RECOVER
免费模型调用失败，先做什么？
- 429：区分账户配额、请求频率与提供商限流。若响应有
Retry-After，按提示等待；没有时也应降低频率，而不是连续快速重试。 - 没有可用提供商：检查当前免费变体是否仍存在、是否支持请求所需能力，以及路由筛选是否过严。
- 402 或额度提示：核对账户状态、消费上限和实际选择的模型，不能仅凭“我想用免费模型”认定请求一定免费。
按 HTTP 状态与错误正文逐项定位，见 OpenRouter API 错误排查。切换到付费模型前应明确费用，不能在用户不知情时自动改为付费。
05 / BEFORE CALLING
调用前的四项核对
- 身份正确：使用 OpenRouter 自己的账户与密钥，没有混用其他 API 服务的密钥或余额。
- 模型正确：完整 ID 来自当前官方页面，明确是指定变体还是免费路由。
- 限制清楚：已检查价格、调用次数、账户状态，以及所选模型的数据处理规则。
- 失败可控：先做小规模试用，设置超时和有限重试，不依赖免费额度承担不可中断的服务。