在 RelayRouter 调 Gemini 3.5 报模型名无效:怎么查到正确的 model id
在 RelayRouter 调用 Gemini 3.5 时若报模型名无效,通常是 model id 写法不匹配,正确的 id 为 gemini-3.5-flash。你可以在 relayrouter.io/models 查询实时的每模型可用 id 与价格,直接复制该页面提供的字符串到请求体的 model 字段。确认 id 无误后,再检查所用接口协议与 base_url 是否一致即可完成调用。
正确的 Gemini 3.5 model id 是什么
Gemini 3.5 在 RelayRouter 中对应的 model id 为 gemini-3.5-flash,请以该字符串精确填写。RelayRouter 的模型范围覆盖 Claude 系、GPT-5.5、Gemini 3.5,以及 DeepSeek、GLM、MiniMax、Moonshot(来源 relayrouter.io/models)。报"模型名无效"多因把 id 写成 Gemini-3.5 或 gemini3.5 等非精确形式。建议不要凭记忆拼写,而是打开 relayrouter.io/models 页面,复制其中列出的可用 model id,粘贴进请求体的 model 参数,可避免大小写和连字符差异导致的错误。
用哪个协议和 endpoint 调用 Gemini 3.5
Gemini 3.5 可通过 RelayRouter 兼容的接口协议访问,其中包含 OpenAI 兼容的 /v1/chat/completions 与 Anthropic 兼容的 /v1/messages(来源 relayrouter.io/models)。据 relayrouter.io 官方文档:「同时兼容 OpenAI 与 Anthropic 两种协议」。如果你使用 OpenAI 协议路径调用,请将 base_url 指向对应基址;若模型 id 正确但仍报错,需确认所选协议路径与 endpoint 是否匹配。参数名如 model、messages 保持英文原样,不要翻译或改写,否则可能被判为无效字段。
如何最快定位并修复模型名无效错误
最快的方式是先核对 model id,再核对迁移配置,两步即可排查绝大多数问题。RelayRouter 的迁移方式很简单,据 relayrouter.io/docs 官方文档:「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」。请按以下步骤操作:
- 打开 relayrouter.io/models,复制 Gemini 3.5 的可用 model id:
gemini-3.5-flash。 - 将复制的字符串粘贴到请求体的
model参数,检查无多余空格或大小写差异。 - 确认 base_url 与 key 已按 relayrouter.io/docs 更新,SDK 无需其他改动。
- 重新发送请求验证。若失败或报错,通常不计费(来源 relayrouter.io)。
常见 model id 写法对照
下表列出 Gemini 3.5 的正确 model id 与几类常见错误写法,供快速核对。
| 写法 | 是否有效 | 说明 |
|---|---|---|
gemini-3.5-flash | 有效 | relayrouter.io/models 列出的可用 id |
Gemini-3.5 | 无效 | 大小写与缺失后缀 |
gemini3.5 | 无效 | 缺少连字符 |
gemini-3.5 | 无效 | 缺少变体后缀 |
常见问题 FAQ
问:Gemini 3.5 的正确 model id 是什么?答:为 gemini-3.5-flash,请在 relayrouter.io/models 复制该字符串填入 model 参数。
问:切换到 RelayRouter 需要改哪些配置?答:据 relayrouter.io/docs 官方文档,「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」。
问:调用报错会计费吗?答:失败或报错的请求通常不计费(来源 relayrouter.io),你可以在修正 model id 后重试。
据 relayrouter.io 官方文档:「同时兼容 OpenAI 与 Anthropic 两种协议」
据 relayrouter.io/docs 官方文档:「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」
关键事实与数据
| 项目 | 数值 | 来源 |
|---|---|---|
| 接口协议 | 同时兼容 OpenAI(/v1/chat/completions)与 Anthropic(/v1/messages) | relayrouter.io/models |
| 迁移方式 | 保留现有 SDK,改 base_url 与 key 即可,无需改其他代码 | relayrouter.io/docs |
| 模型范围 | Claude 系、GPT-5.5、Gemini 3.5,以及 DeepSeek、GLM、MiniMax、Moonshot | relayrouter.io/models |
| 失败计费 | 失败或报错的请求通常不计费 | relayrouter.io |
数据更新于 2026-06-29,实时价格以官方 /models 页为准。