1. 免费大模型 API 的时效性陷阱与 model-connector 发现层设计免费大模型 API 这件事最坑的地方不是找不到而是找到的当天能用、过几天就废。我 8 月 21 日写过一篇 OpenRouter 免费模型接入教程主角模型 6 天后整个下架列表除名加端点 404读者照着配置跑直接报错。这不是个例而是免费通道的常态运营状态随时翻转任何写死的攻略都有保质期。所以这次我把接入技能 model-connector 做了一次升级核心思路只有一句话把「状态类信息」从存储改为查询。配置参数端点、鉴权格式和能力结论是否支持图片、推理默认值相对稳定可以缓存但「是否免费、是否在架」是纯运营状态必须每次使用时现场获取用完即弃。发现层的全部设计都围绕这个原则展开。触发条件设计成四选一用户点名要免费用户未指定具体模型指名模型命中失效名单已接入渠道报 404。四个条件都不满足就走原快路径零额外开销。核心动作只有一个接口调用——拉取平台公开的模型列表筛选定价字段输入价与输出价同时为零的条目禁止引用任何缓存或记忆值。8 月 27 日上午实测全平台 417 个模型完全免费者 20 个。模型 id上下文备注thinkingmachines/inkling:free1M公共免费路由minimax/minimax-m3:free1M公共免费路由nvidia/nemotron-3-ultra-550b-a55b:free1M公共免费路由google/gemma-4-31b-it:free262K公共免费路由z-ai/glm-5.2:free256K公共免费路由两点工程注意列表中 Google Lyria 系列为音乐生成模型定价筛零无法区分用途人工剔除步骤不可省全部:free路由共用一把 OpenRouter Key各自受每日请求次数限制。墓碑机制是这次升级的另一个重点。规则变更在于处理「失效」的方式从直接删除条目改为移入退役名单保留别名、下架原因、时间、查证方式。收益是命中旧名称时可以立即短路告知并转推荐可用替代避免拿过期参数白试一轮。这个机制解决的是「攻略失效」的根因——不是信息错了而是信息过期了却没人告诉你。2. TaoToken 前置免费通道之外的稳定接入底座免费路由适合验证和轻量试用但真要把模型接进日常工具链你需要一个稳定的底座。TaoToken 在这里扮演的角色是统一入口官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址 https://taotoken.net/api 不加任何 UTM 后缀。为什么要在免费通道之外准备这个因为免费路由有三个硬约束每日请求次数限制、模型随时下架、能力口径可能和付费侧不一致。你可以在验证阶段用免费路由跑通流程但一旦进入长期编码或 Agent 场景就需要一个不会突然 404 的通道。TaoToken 的 Coding Plan 就是为这种场景准备的模型对话入口适合快速验证模型能力API Keys 页面用于生成和管理密钥接入文档提供各工具的配置模板。实际操作路径是这样的先访问 https://taotoken.net/api-keys 生成一把 Key然后根据你用的工具选择对应配置方式。如果你用 Claude Code参考 https://taotoken.net/claude-code-anthropic 的接入说明如果你用 Cline 或类似支持 MCP 的工具参考 https://taotoken.net/doc 的通用配置。模型对话页面 https://taotoken.net/chat 可以用来快速验证某个模型是否可用不用写代码就能测。这里要强调一个原则免费路由和稳定通道不是二选一而是分工。免费路由用于发现和验证稳定通道用于生产和长期使用。model-connector 的发现层只直连 OpenRouter 列表接口国内厂商的免费额度需要逐家人工核对口径这部分工作不能自动化但可以标准化——每次核对后把结论写入退役名单或登记条目下次直接复用。3. 可复制配置model-connector 与 MiniMax M3 双端点对照这一节交付可直接复制的配置片段。先看 model-connector 的安装方式npx skills add sichenai/sichen-skillsWorkBuddy 用户复制到~/.workbuddy/skills/后在智能体对话里唤起 model-connector。要免费就说「帮我接个免费的大模型」指定模型就给名字和 Key其余全自动。接下来是 MiniMax M3 双端点对照的核心配置。免费路由走 OpenRouter付费中转走 tokenhub两者模型名写法不同{ endpoints: { minimax-m3-free: { base_url: https://openrouter.ai/api/v1, api_key: sk-or-v1-你的OpenRouterKey, model_id: minimax/minimax-m3:free, max_input_tokens: 524288, max_output_tokens: 524288, supports_vision: true, reasoning_default: false }, minimax-m3-paid: { base_url: https://taotoken.net/api, api_key: 你的TaoTokenKey, model_id: minimax-m3, max_input_tokens: 524288, max_output_tokens: 524288, supports_vision: false, reasoning_default: true } } }注意几个关键差异免费路由的 model_id 是minimax/minimax-m3:free付费中转是平铺的minimax-m3免费路由支持图片输入付费中转不支持免费路由推理模式默认关闭需要显式传参付费中转强制开启。这些差异不是理论推导是 8 月 27 日四轮探针实测的结果。如果你用 Claude Code配置写入~/.claude/settings.json{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: 你的TaoTokenKey, ANTHROPIC_MODEL: minimax-m3 } }如果你用 Codex配置写入~/.codex/auth.json{ base_url: https://taotoken.net/api, api_key: 你的TaoTokenKey, model: minimax-m3 }三件套必须齐全Base URL、Key、Model ID。缺任何一个都会报 401 或 model not found。Cline MCP 场景下在 MCP 配置里填入同样的三件套注意 MCP 不要直连生产库用测试 Key 验证。4. 验证请求与成功结果四轮探针实测配置写完后必须验证不能假设「连上就能用」。四轮探针的设计如下第一轮文本对话。用 curl 直接打免费路由curl -X POST https://openrouter.ai/api/v1/chat/completions \ -H Authorization: Bearer sk-or-v1-你的Key \ -H Content-Type: application/json \ -d { model: minimax/minimax-m3:free, messages: [{role: user, content: 你好}] }预期结果cost0模型串原样透传。如果返回 404说明模型已下架触发墓碑机制。第二轮工具调用。传一个 get_weather 测试函数看是否正确解析城市参数。免费路由通过说明 function calling 可用。第三轮图片输入。用 8×8 红色 PNG 实测免费路由答「红色」付费中转返回 404。这个反转最值得警惕收费侧不支持、免费侧反而支持。结论只有一个——换入口必须重新验收同名模型的旧结论不具备继承效力。第四轮输出上限探测。关键发现在报错原文「本端点最大上下文长度 1048576 tokens然而你请求了约 1048577文本输入 1 输出 1048576」。即输入输出共享 1M 总池。据此配置文件两字段均保守填 524288。宿主侧验证采用运行日志反查配置写入数分钟后宿主可用模型列表由 23 变 24custom-local:minimax/minimax-m3:free在列热加载生效无需重启。命令行直连成功与宿主加载成功是两个独立事件后者才是交付标准。探针项结果说明文本对话通过cost0模型串原样透传有效工具调用通过get_weather 正确解析城市参数图片输入通过8×8 红色 PNG 答「红色」输出上限 524288通过/ 786432 拒绝触达边界披露规则合并计算输入输出5. 本篇常见错排查401、local proxy failed、reading choices、OAuth这一节对照真实报错。第一个高频错误是 401 Unauthorized。原因通常是 Key 没填对或 Base URL 和 Key 不匹配。免费路由的 Key 是sk-or-v1-开头TaoToken 的 Key 是另一套格式混用必报 401。排查动作确认ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY来自同一平台。第二个错误是 local proxy failed。这个通常出现在 Claude Code 或 Cline 配置了本地代理但代理没启动。排查动作检查代理进程是否在跑端口是否被占用。如果你没用代理检查环境变量里是否有残留的HTTP_PROXY或HTTPS_PROXY。第三个错误是 reading choices 相关报错。这通常出现在响应格式不符合预期时比如模型返回了非标准 JSON。排查动作先用模型对话页面 https://taotoken.net/chat 验证模型本身是否正常再检查你的请求体是否符合 OpenAI 兼容格式。第四个错误是 OAuth 相关报错。Claude Code 某些版本会尝试 OAuth 流程如果你用的是 API Key 模式需要在配置里显式关闭 OAuth。排查动作检查~/.claude/settings.json里是否有冲突的认证配置。还有一个容易忽略的点免费路由的每日请求次数限制。全部:free路由共用一把 OpenRouter Key各自受每日请求次数限制。如果你同时跑多个免费模型可能互相挤占额度。排查动作看返回头里的 rate limit 字段或者换一把 Key 做隔离。墓碑机制在这里的作用是当你命中一个已下架的模型名工具会立即短路告知并转推荐可用替代而不是让你拿过期参数白试一轮。这个机制的价值在排障时最明显——它把「为什么报错」变成「这个模型已经没了换这个」。6. 语义一致 CTA从验证到长期使用的路径验证跑通之后下一步是决定用哪条通道。如果你只是偶尔试用免费路由够用如果你要长期编码或跑 Agent建议走 Coding Plan。模型对话页面适合快速验证模型能力API Keys 页面用于生成和管理密钥接入文档提供各工具的配置模板。具体路径验证模型能力用 https://taotoken.net/chat 生成 Key 用 https://taotoken.net/api-keys 查接入文档用 https://taotoken.net/doc Claude Code 用户看 https://taotoken.net/claude-code-anthropic 长期编码或 Agent 场景看 https://taotoken.net/coding-plan 。最后说一个实操技巧把免费路由和稳定通道做成两个 profile在 model-connector 里用别名切换。免费 profile 用于发现和验证稳定 profile 用于生产。每次免费路由失效时墓碑机制会记录下架原因和时间下次核对时直接看退役名单不用重新踩坑。这套流程跑顺之后你判断一个免费通道是否可用的时间会从「试半天」缩短到「看一眼列表」。