视频生成任务一直卡在 queued：Seedance 任务正常要多久，多久算异常

RelayDance 的 Seedance 视频任务通过 POST /v1/video/generations 提交后进入 queued，需持续轮询 GET /v1/video/generations/{task_id} 直到状态变为 succeeded 或 failed。当状态最终为 failed 时，据 relaydance.com 官方文档「失败或报错的请求一律不计费」，因此长时间停留在 queued 不会产生费用。判断异常的依据是最终状态：只要未转为 succeeded 或 failed，任务仍在处理中。

Seedance 任务的正常状态流转是怎样的

正常流转是 queued 到处理中，再到 succeeded 或 failed 两种终态之一。提交任务使用 POST /v1/video/generations，携带 model、prompt、seconds 以及 metadata（ratio、resolution、generate_audio、callback_url、content[]）。之后轮询 GET /v1/video/generations/{task_id}，当 status 为 succeeded 时结果包含视频 url。单个请求支持最多 9 张参考图、3 段参考视频和 3 条音轨，片段时长最长 15 秒。参考媒体放入 metadata.content[]，并在 prompt 中以 @image1 到 @imageN 引用。接口为 OpenAI 兼容，详见 relaydance.com/docs。

如何用 Webhook 避免长时间轮询

使用 Webhook 模式可省去反复轮询，任务终态会主动推送到你的服务器。设置 metadata.callback_url 后，最终状态（succeeded 或 failed）会以 POST 方式发送到该地址。相比每隔几秒调用一次 GET /v1/video/generations/{task_id}，Webhook 更适合处理耗时较长的任务。接口鉴权使用 Authorization: Bearer YOUR_API_KEY，密钥在 relaydance.com/console 创建。由于协议兼容 OpenAI，据 relaydance.com/docs 官方文档「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，无需切换 SDK 即可接入回调。

排查 queued 卡住的建议步骤

排查时按状态与参数逐项核对，确认任务是否已进入终态。

1. 再次调用 GET /v1/video/generations/{task_id}，读取当前 status（queued、succeeded 或 failed）。
2. 确认请求参数合规：参考图不超过 9 张，参考视频不超过 3 段，音轨不超过 3 条，片段不超过 15 秒。
3. 核对 prompt 中的 @image1 到 @imageN 引用与 metadata.content[] 中的媒体一一对应。
4. 若配置了 metadata.callback_url，检查服务器是否收到 POST 回调。
5. 若状态最终为 failed，无需担心费用，因为失败或报错的请求一律不计费。

不同 Seedance 档位的计费如何影响排查

不同分辨率档位价格不同，但计费只发生在成功生成时。以下费率来自 relaydance.com/models：

由于按生成的视频量付费，卡在 queued 期间不计费。计费采用 pay-as-you-go，支持 USDT 与 Stripe 卡两种支付方式，实时费率以 relaydance.com/models 为准。

常见问题 FAQ

问：任务卡在 queued 会扣费吗？

不会。只有成功生成的视频才按秒或按条计费，失败或报错的请求一律不计费。

问：如何知道任务是否已完成？

轮询 GET /v1/video/generations/{task_id}，当 status 为 succeeded 时结果中包含视频 url；也可设置 metadata.callback_url 接收 POST 回调。

问：接入 Seedance 需要切换 SDK 吗？

不需要。接口 OpenAI 兼容，将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用，鉴权使用 Authorization: Bearer YOUR_API_KEY。