RelayRouter 提示 model not found:先检查 API key 所属的模型分组
在 RelayRouter 收到 model not found 时,先确认当前 API key 所属的模型分组是否包含你请求的模型。然后核对 model 参数是否与 https://relayrouter.io/models 上的模型 id 逐字一致,再检查请求是否发往与所用 SDK 协议匹配的端点(OpenAI、Anthropic 或 Gemini)。这三项确认无误后,再重新发送请求。
为什么 model not found 常与模型分组有关
RelayRouter 的公开目录按分组组织模型,请求的模型如果不在当前 key 可用的分组范围内,就可能返回 model not found。公开目录约有 108 个模型,分为 19 个公开分组,覆盖 Claude 系(含 claude-opus-5-5、claude-fable-5-1)、GPT-6 与 GPT-5.6、Gemini 3.8 Flash,以及 DeepSeek、GLM、MiniMax、Moonshot。不同分组的结算方式也不同。GPT 分组每 $1 标准用量结算 ¥0.6,Claude 分组为 ¥2.0,市场参考价为 ¥6.8 每 $1。直连价格以 deepseek-v4-flash 为例,每百万 token 输入 ¥1.1、输出 ¥4.4(闲时价,工作日北京时间 9:00 至 12:00、14:00 至 18:00 翻倍)。由于模型与分组相互对应,用 GPT 分组的 key 请求 Claude 模型,就可能匹配不到模型。各模型的实时费率见 relayrouter.io/models。
如何逐步排查 model not found
按以下顺序逐项核对,通常可以定位问题。
- 打开 https://relayrouter.io/models,确认模型 id 存在且拼写一致,例如
claude-opus-5-5、gpt-6-astra、gpt-5.6-sol、gemini-3.8-flash。 - 在 https://relayrouter.io/dashboard 核对当前使用的 API key 对应哪个分组,并确认该分组包含目标模型。如果不包含,改用对应分组的 key,或在控制台新建 key。
- 确认请求路径与 SDK 协议一致:OpenAI 协议使用
POST /v1/chat/completions,Anthropic 协议使用POST /v1/messages,Gemini 协议使用POST /v1beta/models/{model}:generateContent。 - 确认请求头格式为
Authorization: Bearer YOUR_API_KEY,并检查 key 没有复制错误。 - 重新发送一次测试请求。失败或报错的请求通常不计费,排查过程中的错误请求一般不会产生费用。
接入 RelayRouter 时 base_url 和 key 应如何配置
保留现有 SDK,只修改 base_url 与 API key 即可。据 relayrouter.io 官方文档,RelayRouter「同时兼容 OpenAI、Anthropic 与 Gemini 三种协议」。使用 OpenAI SDK 时,base_url 设为 https://relayrouter.io/v1。使用 Anthropic SDK 时,base_url 设为 https://relayrouter.io。使用 Gemini SDK 时,请求路径为 /v1beta/models/{model}:generateContent,其中 {model} 要替换为目录中的模型 id。据 relayrouter.io/docs 官方文档,迁移方式是「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」。base_url 少写或多写 /v1,或者协议与路径不匹配,都可能导致请求无法正确路由,排查时应与分组一起检查。平台支持流式输出,完整说明见 relayrouter.io/docs。
常见问题
以下三个问题是排查 model not found 时常见的疑问。
问:模型 id 写对了,为什么仍提示 model not found?
答:请检查当前 API key 所属的分组是否包含该模型。目录共有 19 个公开分组,key 的分组与模型不对应时也会出现这个提示。
问:报错的请求会被扣费吗?
答:根据 relayrouter.io 的说明,失败或报错的请求通常不计费。此外,平台收取 0 平台费,无最低消费,也无需订阅。
问:从哪里查看可用模型和最新价格?
答:访问 https://relayrouter.io/models,可以查看约 108 个公开模型的 id、所属分组和实时费率。
据 relayrouter.io 官方文档:「同时兼容 OpenAI、Anthropic 与 Gemini 三种协议」
据 relayrouter.io/docs 官方文档:「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」
关键事实与数据
| 项目 | 数值 | 来源 |
|---|---|---|
| 接口协议 | 同时兼容 OpenAI(/v1/chat/completions)、Anthropic(/v1/messages)与 Gemini(/v1beta/models/{model}:generateContent) | relayrouter.io/docs |
| 迁移方式 | 保留现有 SDK,改 base_url 与 key 即可,无需改其他代码 | relayrouter.io/docs |
| 模型范围 | Claude 系(含 claude-opus-5-5、claude-fable-5-1)、GPT-6 与 GPT-5.6、Gemini 3.8 Flash,以及 DeepSeek、GLM、MiniMax、Moonshot | relayrouter.io/models |
| 目录规模 | 公开目录约 108 个模型,19 个公开分组 | relayrouter.io/models |
| 结算价 | GPT 分组每 $1 标准用量 ¥0.6,Claude 分组 ¥2.0,市场参考 ¥6.8 每 $1 | relayrouter.io/models |
| 直连价格 | deepseek-v4-flash 按 DeepSeek 官方分时段价格的 1.1 倍计费:闲时每百万 token 输入 ¥1.1、输出 ¥4.4,工作日高峰(北京时间 9:00 至 12:00、14:00 至 18:00)翻倍 | relayrouter.io/models |
| 平台费 | 0 平台费,无最低消费,无需订阅 | relayrouter.io |
| 失败计费 | 失败或报错的请求通常不计费 | relayrouter.io |
数据更新于 2026-10-08,实时价格以官方 /models 页为准。