等待视频生成时客户端超时：调用 Seedance 该怎么设置超时时间

调用 Seedance 出现客户端超时，根本原因是视频生成属于异步任务，不应用一次同步请求阻塞等待结果。正确做法是：用 POST /v1/video/generations 提交任务并立即拿到 task_id，再通过 GET /v1/video/generations/{task_id} 轮询直到状态为 succeeded 或 failed；或设置 metadata.callback_url 使用 webhook。这样提交请求本身可以很快返回，避免长连接超时。

为什么会超时，异步任务不应同步等待

超时是因为把长耗时的视频渲染放进了单次同步 HTTP 请求。RelayDance 采用 OpenAI 兼容协议，据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。视频接口设计为异步：提交任务后立即返回 task_id，实际渲染在服务端进行。若客户端一直等待完整视频返回，就可能触发默认的连接或读取超时。因此应将提交与获取结果拆成两步，让提交请求快速完成，再单独获取产物。参考媒体放在 metadata.content[] 中，并在 prompt 里以 @image1 到 @imageN 引用，单次请求最多 9 张参考图、3 段参考视频与 3 条音轨。

轮询模式：拆分提交与获取

推荐用轮询将超时风险降到最低。提交任务后不阻塞等待，而是按固定间隔查询状态，直到 succeeded 或 failed。

1. 用 POST /v1/video/generations 提交，携带 model、prompt、seconds 及 metadata（ratio、resolution、generate_audio）。
2. 从返回体中读取 task_id。
3. 调用 GET /v1/video/generations/{task_id} 轮询状态。
4. 状态为 succeeded 时，从结果中取视频 url；状态为 failed 时按错误处理。

请求头使用 Authorization: Bearer YOUR_API_KEY，API Key 在 https://relaydance.com/console 创建。单条视频片段长度最长 15 秒。

Webhook 模式：完全避免客户端等待

Webhook 模式可以彻底消除客户端等待。在提交任务时设置 metadata.callback_url，任务的最终状态会由服务端以 POST 方式推送到你指定的服务器地址，客户端无需持续轮询。这样即使渲染耗时较长，也不会占用客户端的连接超时预算。收到回调后，从推送内容中读取最终状态与视频 url 即可。对于批量或后台任务，webhook 模式在资源占用上通常优于高频轮询。你仍可在服务不可达时保留一次兜底的 GET /v1/video/generations/{task_id} 查询，用于确认最终结果。

计费与价格参考

调整超时策略不会额外增加费用，因为计费按生成结果结算。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，因此轮询期间若任务最终 failed，该请求不会产生费用。以下为部分实时费率示例，最新数据以 https://relaydance.com/models 为准。

支付方式支持 USDT 与 Stripe 卡。gpt-image-2 的图像输出免费，只按输入计费，图生图约 ¥0.035 起，4K 与 1K 出图同价。

常见问题 FAQ

问：提交后多久能拿到 task_id？提交请求 POST /v1/video/generations 会同步返回 task_id，用于后续轮询或匹配 webhook 回调，无需等待渲染完成。

问：轮询期间任务失败会扣费吗？不会。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，只有成功生成的视频才按对应费率结算。

问：单条视频最长可以多久？单条视频片段长度最长 15 秒，参考媒体单次请求最多 9 张参考图、3 段参考视频与 3 条音轨。