RelayRouter /v1/images/generations 返回 400:尺寸和参数常见错误
RelayRouter 公开文档列出了三类接口:OpenAI 兼容的 /v1/chat/completions、Anthropic 兼容的 /v1/messages,以及 Gemini 兼容的 /v1beta/models/{model}:generateContent。文档中没有 /v1/images/generations,也没有给出图片尺寸参数的规则。收到 400 时,请先确认请求是否发往已文档化的接口,再检查 base_url、model id 和鉴权头。失败或报错的请求通常不计费。
为什么 /v1/images/generations 会返回 400
常见原因是 /v1/images/generations 不在 RelayRouter 已公开的接口范围内。据 relayrouter.io 官方文档,平台「同时兼容 OpenAI、Anthropic 与 Gemini 三种协议」,对应的三个端点都是对话或内容生成类接口。现有资料没有说明图片生成接口的 size 取值、生成数量或返回格式,因此无法判断某个尺寸是否受支持。请不要照搬其他平台的图片参数,也不要据此推断 RelayRouter 的行为。排查时以 https://relayrouter.io/docs 的最新内容为准。如果文档中确实没有该接口,请改用下表列出的已文档化端点,并按对应协议组织请求体。
已文档化的接口与 base URL 对照
请求路径、base URL 和协议必须对应同一套 SDK,混用时容易出现 400。下表依据 https://relayrouter.io/docs 整理:
| 协议 | 请求路径 | base URL |
|---|---|---|
| OpenAI 兼容 | POST /v1/chat/completions | https://relayrouter.io/v1 |
| Anthropic 兼容 | POST /v1/messages | https://relayrouter.io |
| Gemini 兼容 | POST /v1beta/models/{model}:generateContent | 以 relayrouter.io/docs 为准 |
需要注意两点。OpenAI SDK 的 base URL 要带 /v1,Anthropic SDK 的 base URL 不带。Gemini 协议需要把 model id 写进路径中的 {model} 位置。三个接口都支持流式输出。
如何检查参数、模型 ID 与鉴权
大多数 400 可以通过逐项核对 base_url、model id 和请求头排除。据 relayrouter.io/docs 官方文档,迁移时「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」,所以请求体结构应与原 SDK 的格式保持一致。请依次检查以下几项:
- 鉴权头为
Authorization: Bearer YOUR_API_KEY,key 在https://relayrouter.io/dashboard创建。 - model id 与目录中的写法完全一致,例如
claude-opus-5-5、gpt-6-astra、gemini-3.8-flash。 - model id 在
https://relayrouter.io/models中确实存在。公开目录约有 108 个模型,分为 19 个公开分组。
返回 400 的请求是否计费
失败或报错的请求通常不计费,因此排查 400 一般不会产生费用。平台不收取平台费(0 平台费),没有最低消费,也不需要订阅,付款方式为 Stripe 银行卡。请求成功后按模型分组结算,参考价格如下:
- GPT 分组:每 $1 标准用量 ¥0.6。
- Claude 分组:每 $1 标准用量 ¥2.0。
- 市场参考价:每 $1 约 ¥6.8。
- 直连模型
deepseek-v4-flash:每百万 token 输入 ¥1.1,输出 ¥4.4(闲时价,工作日北京时间 9:00 至 12:00、14:00 至 18:00 翻倍)。
各模型的实时费率请查看 https://relayrouter.io/models。
常见问题
以下三个问题汇总了排查 400 时最常遇到的疑问。
RelayRouter 支持 /v1/images/generations 吗?
本文依据的公开资料没有列出这个接口。请以 https://relayrouter.io/docs 的最新说明为准。
图片 size 参数应该怎么填?
现有文档没有提供尺寸参数规则,因此无法给出可用的取值,建议不要套用其他平台的参数。
换成 RelayRouter 后需要改代码吗?
使用已文档化的接口时,保留原有 SDK,修改 base_url 和 API key 即可,其他代码不需要改动。
据 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 页为准。