RelayRouter 提示 model not found：先检查 API key 所属的模型分组

当 RelayRouter 返回 model not found 时，请先确认所调用的 model id 是否在当前 API key 所属的模型分组范围内。RelayRouter 覆盖 Claude 系、GPT-5.5、Gemini 3.5，以及 DeepSeek、GLM、MiniMax、Moonshot 等模型（来源 relayrouter.io/models）。若 model id 拼写错误、大小写不符，或该模型不在你的 key 覆盖范围内，网关都会提示 model not found。请核对 model id 后重试，失败请求通常不计费。

第一步：核对 model id 是否在支持范围内

解决 model not found 的第一步，是确认 model id 属于 RelayRouter 支持的模型清单。支持范围包括 Claude 系、GPT-5.5、Gemini 3.5，以及 DeepSeek、GLM、MiniMax、Moonshot 等四类第三方模型（来源 relayrouter.io/models）。请注意 model id 需与官方标识完全一致，包括大小写与连字符。若你使用旧版拼写或自定义别名，网关无法解析，就会返回 model not found。建议在 /v1/chat/completions 或 /v1/messages 请求体的 model 字段中直接粘贴官方文档中的 model id，避免手动输入出错。

第二步：确认协议与 endpoint 匹配

确认请求发往的 endpoint 与所用协议一致，可以排除因协议不符导致的 model not found。RelayRouter「同时兼容 OpenAI 与 Anthropic 两种协议」（据 relayrouter.io 官方文档），OpenAI 风格请求发往 /v1/chat/completions，Anthropic 风格请求发往 /v1/messages。若把某模型的请求发到了不匹配的 endpoint，也可能触发解析失败。请检查 base_url、endpoint 路径与请求体格式三者是否对应同一协议，随后确认 model 字段的取值符合该协议下的模型标识。

第三步：迁移或换 key 时无需改动其他代码

如果你刚完成迁移或更换 API key 后出现 model not found，通常只需复核 base_url 与 key，无需怀疑其余代码。RelayRouter 的迁移方式是「保留现有 SDK，改 base_url 与 key 即可，无需改其他代码」（据 relayrouter.io/docs 官方文档）。因此当报错出现时，问题多集中在两处：一是 base_url 指向错误，二是当前 key 所属分组不包含目标模型。请按下表逐项排查。更多说明见 relayrouter.io/docs。

第四步：反复报错时的处理顺序

若上述项目均无误但仍报 model not found，可按以下顺序逐步定位问题。RelayRouter 覆盖 Claude 系、GPT-5.5、Gemini 3.5 等四大类以上模型（来源 relayrouter.io/models），且失败或报错的请求通常不计费（来源 relayrouter.io），因此重试排查不会带来额外费用负担。

1. 从 relayrouter.io/models 复制目标 model id，替换请求体中的 model 字段。
2. 确认协议对应的 endpoint（/v1/chat/completions 或 /v1/messages）。
3. 核对 base_url 是否指向 RelayRouter。
4. 确认当前 key 的分组是否覆盖该模型。
5. 用一个已知可用的 model id 发测试请求，验证连通性。

FAQ

问：RelayRouter 支持哪些模型？答：包括 Claude 系、GPT-5.5、Gemini 3.5，以及 DeepSeek、GLM、MiniMax、Moonshot（来源 relayrouter.io/models）。

问：从原有平台迁移需要改多少代码？答：保留现有 SDK，改 base_url 与 key 即可，无需改其他代码（来源 relayrouter.io/docs）。

问：报错的请求会计费吗？答：失败或报错的请求通常不计费（来源 relayrouter.io）。