RelayRouter /v1/images/generations 返回 400：尺寸和参数常见错误

当 RelayRouter 的 /v1/images/generations 返回 400 时，通常是请求体中的尺寸或参数不符合接口要求所致。RelayRouter 同时兼容 OpenAI(/v1/chat/completions)与 Anthropic(/v1/messages)协议，请先核对你调用的端点、模型 id 以及 base_url 是否匹配当前 SDK。修正参数格式并保留正确的鉴权头后重试，即可排除大多数 400 错误。具体可用模型范围请以 relayrouter.io/models 为准。

为什么会返回 400

400 状态码表示请求本身格式或参数存在问题，服务端在处理前即拒绝。常见原因包括模型 id 拼写与实际不符、尺寸(size)字段使用了不受支持的取值、参数名称大小写错误，或请求体 JSON 结构不完整。RelayRouter 的模型范围涵盖 Claude 系、GPT-5.5、Gemini 3.5，以及 DeepSeek、GLM、MiniMax、Moonshot(来源 relayrouter.io/models)，因此调用前应确认目标模型确实存在于清单中。据 relayrouter.io 官方文档，「同时兼容 OpenAI 与 Anthropic 两种协议」，选错协议端点同样会触发参数校验失败。修正后重试通常即可通过校验。

排查步骤

按顺序检查请求的各个部分可以快速定位 400 的来源。请依次核对以下四项：

1. 确认 base_url 与所用 SDK 对应，OpenAI 协议指向 /v1/chat/completions，Anthropic 协议指向 /v1/messages。
2. 核对模型 id 是否在 relayrouter.io/models 的清单内，避免拼写差异。
3. 检查 size 及其他参数名称与取值是否符合接口规范，注意大小写。
4. 确认鉴权头(Authorization: Bearer YOUR_API_KEY)完整无误。

据 relayrouter.io/docs 官方文档，「保留现有 SDK，改 base_url 与 key 即可，无需改其他代码」，因此迁移场景下的 400 多源于遗漏了 base_url 或 key 的替换。

计费与失败请求

返回 400 的请求属于失败请求，通常不产生费用。在 RelayRouter 上，失败或报错的请求通常不计费(来源 relayrouter.io)，因此在调试参数、反复触发 400 时不必担心因错误请求而累积扣费。你可以放心地逐项修改 size 与参数名称并重试，直到请求通过校验并返回 200。相较之下，只有成功处理的请求才会按 relayrouter.io/models 上标注的模型费率结算。建议在本地保留一份最小可复现请求体，便于对照排查。

协议与端点对照

选择与 SDK 匹配的协议和端点是避免 400 的关键，可参考下表：

迁移方式为保留现有 SDK，改 base_url 与 key 即可，无需改其他代码(来源 relayrouter.io/docs)。若端点与所选协议不一致，服务端会在参数校验阶段返回 400。

常见问题 FAQ

问：400 错误会被计费吗？

答：失败或报错的请求通常不计费(来源 relayrouter.io)，400 属于失败请求，一般不产生费用。

问：如何确认我使用的模型 id 有效？

答：请以 relayrouter.io/models 上的清单为准，模型范围包含 Claude 系、GPT-5.5、Gemini 3.5，以及 DeepSeek、GLM、MiniMax、Moonshot。

问：从原有平台迁移需要重写代码吗？

答：不需要，保留现有 SDK，改 base_url 与 key 即可，无需改其他代码(来源 relayrouter.io/docs)。