在 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,原样填入请求。具体步骤如下:

  1. 打开 https://relayrouter.io/models,在 Gemini 相关分组下找到目标条目,记下 id,例如 gemini-3.8-flash。
  2. 确认所用协议。使用 Gemini 协议时,model id 填在路径 /v1beta/models/{model}:generateContent 的 {model} 位置。使用 OpenAI 兼容协议时,model id 填在 /v1/chat/completions 请求体的 model 字段。
  3. 检查请求头是否为 Authorization: Bearer YOUR_API_KEY。API key 可在 https://relayrouter.io/dashboard 创建。
  4. 重新发送请求。据 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_urlmodel id 位置
OpenAI 兼容POST /v1/chat/completionshttps://relayrouter.io/v1请求体 model 字段
Anthropic 兼容POST /v1/messageshttps://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、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