视频任务显示 failed 却没有报错信息：Seedance 排查清单

当 Seedance 视频任务返回 failed 却没有明确报错信息时，请先确认：失败请求不会产生费用，据 relaydance.com 官方文档，「失败或报错的请求一律不计费」。随后通过 GET /v1/video/generations/{task_id} 轮询获取最终状态，逐项检查参考媒体数量（最多 9 张图、3 段视频、3 条音轨）、片段时长（不超过 15 秒）、prompt 中的 @image1 引用是否匹配，以及 base_url 是否已改为 https://relaydance.com/v1。

先确认失败不计费，再排查

在开始排查前，请确认 failed 状态不会产生任何费用。RelayDance 采用按生成量付费（pay-as-you-go）的计费方式，据 relaydance.com 官方文档，「失败或报错的请求一律不计费」。这意味着你可以放心重试，无需担心排查过程带来额外成本。轮询接口 GET /v1/video/generations/{task_id} 会返回 status 字段，当值为 succeeded 时结果包含视频 url，当值为 failed 时表示任务未成功。若你使用 webhook 模式，可在 metadata.callback_url 中设置回调地址，最终状态会以 POST 方式发送到你的服务器，便于集中收集失败记录。

逐项检查参考媒体与时长限制

failed 通常与参考媒体或参数超限相关，请对照配额逐项核对。参考媒体放在 metadata.content[] 中，并在 prompt 里用 @image1 到 @imageN 引用。每次请求的上限如下表：

请确认 prompt 中的 @imageN 编号与 content[] 中媒体的实际顺序一致，未匹配的引用可能导致任务失败。同时确保片段时长不超过 15 秒，参考图片不超过 9 张。

核对接口配置与鉴权

接口配置错误也会造成任务无法正常提交，请检查 base_url 与鉴权头。RelayDance 采用 OpenAI 兼容协议，据 relaydance.com 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。排查步骤如下：

1. 确认 base_url 已设为 https://relaydance.com/v1。
2. 确认请求头包含 Authorization: Bearer YOUR_API_KEY，密钥可在 https://relaydance.com/console 创建。
3. 确认提交任务使用 POST /v1/video/generations，并携带 model、prompt、seconds 及 metadata 字段。
4. 通过 GET /v1/video/generations/{task_id} 轮询直到 status 为 succeeded 或 failed。

更多接口细节见 https://relaydance.com/docs。

确认预算与重试策略

排查完成后重试前，请确认预算与目标分辨率对应的费率。由于失败请求不计费，重试仅按成功生成量收费。参考实时费率（详见 https://relaydance.com/models）：Seedance 2.0 720p 约 $0.190 / 秒，Seedance 2.0 1080p 约 $0.470 / 秒，Seedance Fast 约 $0.152 / 秒，Seedance 原生 4K 约 $4.90 / 5 秒条。支付方式支持 USDT 与 Stripe 卡。若你在高分辨率下反复调试，可先用 Seedance Fast（约 $0.152 / 秒）验证参数，确认无误后再切换到目标模型正式生成，从而降低调试成本。

常见问题（FAQ）

failed 的任务会扣费吗？

不会。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，重试不会因先前失败产生额外费用。

一次请求最多能放多少参考媒体？

每次请求最多 9 张参考图片、3 段参考视频和 3 条音轨，单个片段时长不超过 15 秒，媒体放在 metadata.content[] 中并在 prompt 里用 @image1 到 @imageN 引用。

如何用现有 OpenAI SDK 调用？

据 relaydance.com 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，同时在请求头设置 Authorization: Bearer YOUR_API_KEY。