/v1/video/generations 返回 400 bad request：最常见的参数错误汇总

调用 POST /v1/video/generations 返回 400 bad request，通常源于必填参数缺失或取值超限：请检查 model、prompt、seconds 是否齐全，确认 metadata.content[] 中引用媒体不超过上限（最多 9 张参考图、3 段参考视频、3 条音频），并保证单条片段不超过 15 秒。RelayDance 采用 OpenAI 兼容协议，base_url 应为 https://relaydance.com/v1。参数修正后即可正常提交任务。

必填字段缺失或类型错误

400 错误多数由 model、prompt 或 seconds 缺失引起。提交视频任务时，请求体必须同时包含这三个字段：model 指定模型（如 Seedance 2.0），prompt 为文本描述，seconds 为整数秒数。metadata 内可放 ratio、resolution、generate_audio 和 callback_url。RelayDance 保留 OpenAI SDK 使用方式，据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。若 base_url 未改或字段类型不符（例如 seconds 传字符串），网关会以 400 拒绝。

参考媒体数量或引用超限

参考媒体超出数量上限是 400 的常见原因。参考图片、视频和音频统一放入 metadata.content[]，并在 prompt 中以 @image1 到 @imageN 的形式引用。单次请求最多支持 9 张参考图、3 段参考视频和 3 条音频，任一类别超限都会触发 400 bad request。此外，单条片段时长上限为 15 秒，超出即报错。请核对 content[] 数组长度与 prompt 中的 @imageN 编号一一对应，避免引用了数组中不存在的序号，这类不一致同样会被判为无效参数。

分辨率与计费相关的取值问题

resolution 取值需与所选模型支持的档位匹配，否则返回 400。RelayDance 按秒或按条计费，具体档位可在 https://relaydance.com/models 查看：Seedance 2.0 720p 约 $0.190 / 秒，1080p 约 $0.470 / 秒，Seedance Fast 约 $0.152 / 秒，Seedance 原生 4K 约 $4.90 / 5 秒条。若在参数校验阶段被拒，无需担心费用，据 relaydance.com 官方文档，「失败或报错的请求一律不计费」。因此可放心修正参数后重试，仅成功生成的视频才会计费。

排查步骤与常见错误对照

按以下顺序排查可快速定位 400 的具体原因。

1. 确认 Authorization: Bearer YOUR_API_KEY 已带上，密钥在 https://relaydance.com/console 创建。
2. 检查 base_url 是否为 https://relaydance.com/v1。
3. 核对 model、prompt、seconds 三个必填字段。
4. 校验 metadata.content[] 数量与 prompt 中 @imageN 引用。

常见问题 FAQ

问题一：400 报错会扣费吗？不会。据 relaydance.com/docs 官方文档说明，失败或报错的请求一律不计费，仅成功生成的视频按 https://relaydance.com/models 的档位计费。

问题二：一次请求最多能放多少参考素材？最多 9 张参考图、3 段参考视频和 3 条音频，单条片段不超过 15 秒，超出会返回 400 bad request。

问题三：接口是否兼容 OpenAI SDK？兼容。将 base_url 改为 https://relaydance.com/v1 并保留原有 OpenAI SDK 调用方式即可，详见 https://relaydance.com/docs。