在 RelayRouter 调 Gemini 3.5 报模型名无效:怎么查到正确的 model id
报“模型名无效”,通常是因为请求中的 model 值与 RelayRouter 目录中的 model id 不一致。根据 relayrouter.io/models 公开目录,目前列出的 Gemini 型号是 Gemini 3.8 Flash,对应 model id 为 gemini-3.8-flash。已知的目录资料中没有 Gemini 3.5。请先在该页面核对实时 id,再把 model 参数改成目录中的原样字符串。
为什么会报模型名无效
请求里的模型名没有匹配到 RelayRouter 公开目录中的任何条目,网关就会报这个错误。据 relayrouter.io/models,公开目录约有 108 个模型,分为 19 个公开分组,覆盖以下模型:Claude 系(含 claude-opus-5-5、claude-fable-5-1)、GPT-6 与 GPT-5.6、Gemini 3.8 Flash,以及 DeepSeek、GLM、MiniMax、Moonshot。常见的填写错误有三类:凭记忆写版本号(例如写成 3.5),大小写或连字符与目录不同,以及漏写 flash 这类后缀。model id 必须与目录中的写法逐字一致,否则请求无法路由到对应模型。
如何查到并填入正确的 model id
以 relayrouter.io/models 页面为准,复制目录中的 model id,原样填入请求。具体步骤如下:
- 打开 https://relayrouter.io/models,在 Gemini 相关分组下找到目标条目,记下 id,例如
gemini-3.8-flash。 - 确认所用协议。使用 Gemini 协议时,model id 填在路径
/v1beta/models/{model}:generateContent的{model}位置。使用 OpenAI 兼容协议时,model id 填在/v1/chat/completions请求体的model字段。 - 检查请求头是否为
Authorization: Bearer YOUR_API_KEY。API key 可在 https://relayrouter.io/dashboard 创建。 - 重新发送请求。据 relayrouter.io,失败或报错的请求通常不计费,因此排查过程中的重试成本有限。
切换协议或 SDK 时需要改什么
切换协议时只需调整 base_url 与 key,model id 仍以目录为准。据 relayrouter.io 官方文档,RelayRouter「同时兼容 OpenAI、Anthropic 与 Gemini 三种协议」。迁移方式方面,据 relayrouter.io/docs 官方文档,用户可以「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」。三种协议的对应关系如下,接口细节见 relayrouter.io/docs:
| 协议 | 端点 | base_url | model id 位置 |
|---|---|---|---|
| OpenAI 兼容 | POST /v1/chat/completions | https://relayrouter.io/v1 | 请求体 model 字段 |
| Anthropic 兼容 | POST /v1/messages | https://relayrouter.io | 请求体 model 字段 |
| Gemini 兼容 | POST /v1beta/models/{model}:generateContent | 见 relayrouter.io/docs | 路径中的 {model} |
选对模型后如何计费
RelayRouter 按模型分组结算,不收平台费。据 relayrouter.io/models,GPT 分组每 $1 标准用量结算 ¥0.6,Claude 分组为 ¥2.0,市场参考价为每 $1 ¥6.8。直连计价的模型以 deepseek-v4-flash 为例,每百万 token 输入 ¥1.1、输出 ¥4.4(闲时价,工作日北京时间 9:00 至 12:00、14:00 至 18:00 翻倍)。资料中没有给出 Gemini 分组的具体费率,请以 models 页面的实时价格为准。据 relayrouter.io,平台费为 0,不设消费下限,也无需订阅。付款方式为 Stripe 银行卡,支持流式输出。
常见问题
问:能直接把 model 写成 Gemini 3.5 吗?
答:已知的目录资料只列出了 gemini-3.8-flash,没有 Gemini 3.5。是否新增了其他 Gemini 版本,请以 relayrouter.io/models 的实时目录为准。
问:从官方 SDK 迁移过来需要改业务代码吗?
答:不需要。保留现有 SDK,只修改 base_url 与 API key,再把 model 改成目录中的 id 即可。
问:因模型名无效而报错的请求会扣费吗?
答:据 relayrouter.io,失败或报错的请求通常不计费。
据 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 页为准。