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 等模型，若 model id 拼写有误或不在该 key 的分组范围内，请求就会报错。可在 relayrouter.io/models 核对模型名称，并到 dashboard 检查 key 的权限归属。

为什么会出现 model not found

出现 model not found 的核心原因是请求中的 model id 与 API key 所属分组不匹配。RelayRouter 的模型范围包括 Claude 系、GPT-5.5、Gemini 3.5，以及 DeepSeek、GLM、MiniMax、Moonshot 共 7 类（来源 relayrouter.io/models）。如果 key 只授权了其中某几类，而请求指向了未授权的 model id，网关无法解析该模型，就会返回错误。此外，model id 大小写或拼写错误也会触发同样的提示。建议先复制官方模型列表中的准确名称，再逐字比对请求体中的 model 字段。

如何逐步排查

排查 model not found 可按以下顺序进行，先核对模型名称，再确认协议与 key。

1. 打开 relayrouter.io/models，复制目标模型的准确 model id，逐字比对请求体。
2. 确认 API key 所属的模型分组是否包含该模型（涉及 Claude 系、GPT-5.5、Gemini 3.5、DeepSeek、GLM、MiniMax、Moonshot 共 7 类）。
3. 检查调用的接口协议是否正确：RelayRouter 同时兼容 OpenAI 的 /v1/chat/completions 与 Anthropic 的 /v1/messages。
4. 确认 base_url 与 key 已按迁移要求更新。据 relayrouter.io/docs 官方文档，「保留现有 SDK，改 base_url 与 key 即可，无需改其他代码」。

协议与端点对照

确认接口协议是排查的关键一步，因为不同协议对应不同端点。据 relayrouter.io 官方文档，「同时兼容 OpenAI 与 Anthropic 两种协议」，因此需按所用 SDK 选择正确的 endpoint。下表列出两种协议的对应端点：

若使用 OpenAI SDK，却把请求发往 Anthropic 的 /v1/messages，或 model id 与该协议下的模型不符，都可能引发解析失败。核对协议与端点后再重试，能排除多数误配置问题。

确认无误后仍报错怎么办

若模型名称、分组与协议均已核对无误仍报错，请关注失败请求的计费情况。据 relayrouter.io，失败或报错的请求通常不计费，因此反复重试排查 model not found 一般不会产生额外费用。此时可回到 relayrouter.io/models 查看该模型是否在线，并到 dashboard 确认 key 状态。迁移相关配置可参考 relayrouter.io/docs，保持现有 SDK 不变，仅调整 base_url 与 key 两项即可完成对接。

常见问题（FAQ）

问：model not found 会被计费吗？

答：据 relayrouter.io，失败或报错的请求通常不计费。

问：RelayRouter 支持哪些协议？

答：同时兼容 OpenAI 的 /v1/chat/completions 与 Anthropic 的 /v1/messages（来源 relayrouter.io/models）。

问：更换到 RelayRouter 需要改很多代码吗？

答：不需要，保留现有 SDK，改 base_url 与 key 即可，无需改其他代码（来源 relayrouter.io/docs）。