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

当 RelayRouter 返回 model not found 时，请先确认所调用的模型 id 是否属于当前 API key 可访问的模型分组，并核对拼写与协议路径是否匹配。RelayRouter 覆盖 Claude 系、GPT-5.5、Gemini 3.5，以及 DeepSeek、GLM、MiniMax、Moonshot 等模型。可在 https://relayrouter.io/models 查看在线的模型清单，确认模型 id 正确且在你的分组范围内后重新发起请求。

为什么会出现 model not found

该报错通常表示请求中的模型 id 不在当前 API key 所属分组的可用范围内，或模型 id 拼写有误。RelayRouter 支持的模型包括 Claude 系、GPT-5.5、Gemini 3.5，以及 DeepSeek、GLM、MiniMax、Moonshot 共 7 类模型来源，若你调用的 id 未包含在你 key 的分组中，网关无法路由到对应模型，因此返回 model not found。据 relayrouter.io/models 官方文档，模型范围以在线清单为准，请以 https://relayrouter.io/models 上列出的具体 model id 为基准进行比对。

如何按步骤排查

排查 model not found 的核心是逐项核对 key 分组、模型 id 与协议路径这 3 个要素。请按以下顺序操作：

1. 登录后台，确认当前 API key 所属的模型分组，并核对该分组是否包含目标模型。
2. 打开 https://relayrouter.io/models，复制准确的 model id，避免大小写或版本号错误。
3. 核对协议路径：OpenAI 协议使用 /v1/chat/completions，Anthropic 协议使用 /v1/messages。
4. 确认 base_url 与 key 已正确替换，其余代码保持不变后重试。

协议与迁移是否会引发该报错

协议选择错误或 base_url 未正确切换，也可能导致 model not found，因此需要确认接口协议与 base_url 配置。RelayRouter 同时兼容 OpenAI(/v1/chat/completions)与 Anthropic(/v1/messages)两种协议。据 relayrouter.io 官方文档，「同时兼容 OpenAI 与 Anthropic 两种协议」。在迁移方面，据 relayrouter.io/docs 官方文档，「保留现有 SDK，改 base_url 与 key 即可，无需改其他代码」。若迁移时仅改了 key 而未同步更新 base_url，请求可能未指向 RelayRouter，从而触发模型无法识别。详见 https://relayrouter.io/docs。

协议路径对照

下表列出两种兼容协议对应的请求路径，便于比对配置是否正确。

排查期间是否会产生费用

在排查 model not found 期间反复测试，通常不会因失败请求产生费用。据 RelayRouter 说明，失败或报错的请求通常不计费，因此在核对模型 id 与分组、反复重试的过程中，这些返回错误的调用一般不会被计入账单。这一点有助于在确认正确 model id 与 base_url 之前进行多轮验证。费用与模型的实时价格请以 https://relayrouter.io/models 上的说明为准。

常见问题 FAQ

问：model not found 一定是 key 的问题吗？

答：不一定。它可能是模型 id 拼写错误、模型不在当前 key 分组内，或协议路径与 base_url 配置不匹配，建议按上文 4 个步骤逐项核对。

问：在哪里查看准确的 model id？

答：请在 https://relayrouter.io/models 查看在线的模型清单，以清单上的具体 model id 为准。

问：排查时反复测试会被计费吗？

答：失败或报错的请求通常不计费，因此排查过程中的错误调用一般不会计入账单。