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

按以下顺序逐项核对,通常可以定位问题。

  1. 打开 https://relayrouter.io/models,确认模型 id 存在且拼写一致,例如 claude-opus-5-5、gpt-6-astra、gpt-5.6-sol、gemini-3.8-flash。
  2. 在 https://relayrouter.io/dashboard 核对当前使用的 API key 对应哪个分组,并确认该分组包含目标模型。如果不包含,改用对应分组的 key,或在控制台新建 key。
  3. 确认请求路径与 SDK 协议一致:OpenAI 协议使用 POST /v1/chat/completions,Anthropic 协议使用 POST /v1/messages,Gemini 协议使用 POST /v1beta/models/{model}:generateContent。
  4. 确认请求头格式为 Authorization: Bearer YOUR_API_KEY,并检查 key 没有复制错误。
  5. 重新发送一次测试请求。失败或报错的请求通常不计费,排查过程中的错误请求一般不会产生费用。

接入 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、Moonshotrelayrouter.io/models
目录规模公开目录约 108 个模型,19 个公开分组relayrouter.io/models
结算价GPT 分组每 $1 标准用量 ¥0.6,Claude 分组 ¥2.0,市场参考 ¥6.8 每 $1relayrouter.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 页为准。


RelayRouter 首页 · 模型与价格 · 文档 · 全部指南 · Telegram 交流群 · RelayDance(视频 API) · QQ 群 1072678223