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

Seedance 任务通过 POST /v1/video/generations 提交后进入 queued 状态，需用 GET /v1/video/generations/{task_id} 轮询直到 status 变为 succeeded 或 failed。若长时间停留在 queued，可先确认参数与鉴权是否正确。RelayDance 采用按生成付费，据 relaydance.com 官方文档「失败或报错的请求一律不计费」，因此排查失败任务不产生费用。实时费率见 relaydance.com/models。

任务状态如何流转

任务状态从 queued 经处理到 succeeded 或 failed，需要主动轮询获取结果。提交后接口返回 task_id，随后调用 GET /v1/video/generations/{task_id} 查询当前 status，成功时结果中包含视频 url。若不想轮询，可在 metadata.callback_url 设置 Webhook，任务终态会被 POST 到你的服务器。单条 clip 支持最长 15 秒，参考媒体放在 metadata.content[] 中并在 prompt 里以 @image1 到 @imageN 引用，每次请求最多 9 张参考图、3 段参考视频与 3 条音轨。终态为 failed 时不会计费。

多久算异常，如何排查

判断异常应结合轮询结果与参数正确性，而非单纯依据等待时间。若 status 始终为 queued 且长时间无变化，优先检查 Authorization: Bearer YOUR_API_KEY 是否有效（在 relaydance.com/console 创建），以及 model、prompt、seconds 等字段是否合规。RelayDance 为 OpenAI 兼容接口，据 relaydance.com/docs 官方文档「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，base_url 配置错误会导致请求无法正常进入队列。参考媒体超过 9 张图、3 段视频或 3 条音轨的上限，或 clip 超过 15 秒，都可能造成任务无法推进。任务最终转为 failed 时同样不计费。

各模型价格对照

不同 Seedance 模型的计费按分辨率或时长区分，可据此估算成本并选择合适档位。

其中 gpt-image-2 的图像输出免费，只按输入计费。完整实时费率请查看 relaydance.com/models。

排查 queued 的操作步骤

遇到任务卡在 queued，可按以下顺序检查。

1. 确认 base_url 已设为 https://relaydance.com/v1，并保留 OpenAI SDK。
2. 确认请求头包含 Authorization: Bearer YOUR_API_KEY，密钥在 console 有效。
3. 核对 model、prompt、seconds 及 metadata（ratio、resolution、generate_audio 等）字段。
4. 检查 metadata.content[] 是否超过 9 张图、3 段视频、3 条音轨的上限，clip 是否超过 15 秒。
5. 持续调用 GET /v1/video/generations/{task_id} 轮询，或改用 metadata.callback_url 接收终态。
6. 若终态为 failed，可直接重试，失败请求不产生费用。

常见问题 FAQ

问：任务卡在 queued 会计费吗？ 计费按生成的视频进行，只有成功产出才计费，失败或报错的请求不计费。

问：能不能不轮询就拿到结果？ 可以，在 metadata.callback_url 设置 Webhook，任务终态会被 POST 到你的服务器。

问：使用 Seedance 需要 BytePlus 企业账号或 KYC 吗？ 不需要，RelayDance 提供 OpenAI 兼容的直接访问，付款支持 USDT 与 Stripe 银行卡，详见 relaydance.com/docs。