在 RelayRouter 调 Gemini 3.5 报模型名无效:怎么查到正确的 model id

在 RelayRouter 调用 Gemini 3.5 时若提示模型名无效,通常是 model id 写错。正确的 Gemini 3.5 模型 id 是 gemini-3.5-flash,而不是 Gemini 3.5 这类展示名称。请在请求体的 model 字段填入准确的 id,并以 relayrouter.io/models 上的实时列表为准,该页面提供各模型的可用 model id 与实时价格。

正确的 Gemini 3.5 model id 是什么

RelayRouter 上 Gemini 3.5 对应的 model id 为 gemini-3.5-flash。报"模型名无效"多因把界面展示名(如 Gemini 3.5)直接当作 model id 提交。除 Gemini 3.5 外,平台还覆盖 Claude 系(如 claude-opus-4-8claude-fable-5)、gpt-5.5,以及 DeepSeek、GLM、MiniMax、Moonshot 等系列。任何时候都应以 relayrouter.io/models 页面的实时清单为准,该页列出各模型可用的 model id,避免使用过期或拼写错误的名称导致请求被拒。

如何查到并确认 model id

查 model id 的方法是打开模型列表页并复制字段中的英文 id。按以下步骤操作:

  1. 访问 https://relayrouter.io/models 查看实时的每模型清单与价格。
  2. 在列表中定位 Gemini 3.5,复制其 model id:gemini-3.5-flash
  3. 将该字符串原样填入请求体的 model 字段,注意大小写与连字符。
  4. https://relayrouter.io/dashboard 创建 API key,并使用 Authorization: Bearer YOUR_API_KEY 鉴权。
  5. 发起测试请求,确认返回正常后再接入正式流程。

若仍报错,请核对是否误用了展示名或多余空格。

用哪个协议和 endpoint 调 Gemini 3.5

调用 Gemini 3.5 可使用 Gemini 兼容接口,也可通过 OpenAI 或 Anthropic 兼容协议访问。据 relayrouter.io 官方文档,「同时兼容 OpenAI 与 Anthropic 两种协议」。三种协议对应不同 endpoint,请依据所用 SDK 选择。下表列出对应关系:

协议EndpointBase URL
OpenAI 兼容POST /v1/chat/completionshttps://relayrouter.io/v1
Anthropic 兼容POST /v1/messageshttps://relayrouter.io
Gemini 兼容POST /v1beta/models/{model}:generateContenthttps://relayrouter.io

使用 Gemini 兼容接口时,将 {model} 替换为 gemini-3.5-flash。三种协议均支持流式输出(streaming)。

迁移到 RelayRouter 需要改哪些代码

迁移只需修改 base URL 与 API key,无需改动其他代码。据 relayrouter.io/docs 官方文档,「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」。这意味着现有 OpenAI、Anthropic 或 Gemini SDK 可继续沿用,只把 base URL 指向 RelayRouter 并替换密钥。计费方面,失败或报错的请求通常不计费,因此因 model id 无效而失败的调试请求一般不会产生费用。主流模型组的价格平均较官方约低 30 percent,且无平台费。详细价格与 model id 请见 relayrouter.io/docsrelayrouter.io/models

常见问题 FAQ

问:Gemini 3.5 的 model id 到底填什么?

答:填 gemini-3.5-flash,不要填展示名 Gemini 3.5。最新可用 id 以 relayrouter.io/models 为准。

问:报模型名无效的失败请求会扣费吗?

答:失败或报错的请求通常不计费,因此调试期间的无效请求一般不产生费用。

问:切换到 RelayRouter 后要重写 SDK 吗?

答:不需要。保留现有 SDK,只改 base_url 与 key 即可,其他代码无需改动。

据 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、Moonshotrelayrouter.io/models
失败计费失败或报错的请求通常不计费relayrouter.io

数据更新于 2026-06-29,实时价格以官方 /models 页为准。


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