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

当 POST /v1/video/generations 返回 400 bad request 时，通常源于必填字段缺失或取值超限：请确认请求体包含 model、prompt 和 seconds，检查 metadata.content[] 中的参考媒体未超过每次请求 9 张图、3 段视频与 3 条音轨的上限，且单条片段不超过 15 秒。参数格式或引用 @image1 到 @imageN 不一致，也会触发该错误。修正后重新提交即可。

必填字段与取值范围检查

大多数 400 错误来自缺少必填字段或取值超出限制。POST /v1/video/generations 要求提供 model、prompt 和 seconds 三个基础字段，其余通过 metadata 传入，包括 ratio、resolution、generate_audio 和 callback_url。参考媒体放在 metadata.content[] 中，每次请求最多可携带 9 张参考图、3 段参考视频和 3 条音轨，单条片段时长不超过 15 秒。超过任一上限都会返回 400，请先核对数量与时长再提交。计费方面，据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，因此调试期间无需担心 400 请求产生费用。

参考媒体引用与 @imageN 一致性

参考图引用不一致是另一类常见 400 触发点。参考媒体在 metadata.content[] 中按顺序排列，并需在 prompt 文本中以 @image1 到 @imageN 的形式逐一引用。若 prompt 引用了 @image3 但 content[] 只提供了两张图，或引用编号与数组顺序不匹配，服务端会拒绝请求。建议按以下步骤排查：

1. 统计 content[] 中实际的图像数量。
2. 确认 prompt 中 @imageN 的最大编号不超过该数量。
3. 核对图、视频、音轨分别未超过 9、3、3 的上限。
4. 确认单条片段时长不超过 15 秒。

base_url 与鉴权配置

接口地址或鉴权头配置错误也可能导致请求被拒。RelayDance 采用 OpenAI 兼容协议，据 relaydance.com 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。请确认 base_url 已指向 https://relaydance.com/v1，并在请求头中携带 Authorization: Bearer YOUR_API_KEY，API Key 可在 https://relaydance.com/console 创建。若使用 Webhook 模式，需在 metadata.callback_url 中填入可访问的服务端地址，最终状态会以 POST 方式回调；否则可通过 GET /v1/video/generations/{task_id} 轮询，直到 status 变为 succeeded 或 failed。更多参数说明见 https://relaydance.com/docs。

不同分辨率的费率对照

修正 400 错误后，可参考各档位费率评估成本。以下为 Seedance 相关模型的计费方式，实时费率以 https://relaydance.com/models 为准。

此外，gpt-image-2 的图像输出免费，只按输入计费；图生图约 ¥0.035 起，4K 与 1K 出图同价。计费为按生成量的 pay-as-you-go 模式，支付方式支持 USDT 与 Stripe 卡。

FAQ

问：400 bad request 会被计费吗？

不会。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，返回 400 的请求不产生费用。

问：一次请求最多能带多少参考媒体？

每次请求最多 9 张参考图、3 段参考视频、3 条音轨，单条片段不超过 15 秒，超限会返回 400。

问：需要 BytePlus 企业账号或 KYC 吗？

不需要。RelayDance 提供 OpenAI 兼容的 Seedance 访问方式，将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用。