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

视频生成属于异步任务，因此正确做法是不要在单个 HTTP 请求上等待结果，而应采用轮询或 Webhook。通过 POST /v1/video/generations 提交任务后立即返回 task_id，再用 GET /v1/video/generations/{task_id} 轮询到 succeeded 或 failed；或设置 metadata.callback_url 让最终状态回调到你的服务器。RelayDance 接口为 OpenAI 兼容，base_url 改为 https://relaydance.com/v1 即可，详见 relaydance.com/docs。

为什么会超时：同步等待与异步任务的区别

客户端超时通常来自把异步任务当作同步请求来等待。视频生成需要一定处理时间，若在提交请求的连接上一直阻塞等待视频 url，默认的客户端超时（例如 SDK 或网关的读超时）就会先触发。RelayDance 的设计是提交与获取结果分离：POST /v1/video/generations 返回 task_id，随后通过 GET /v1/video/generations/{task_id} 查询状态。据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，因此只需沿用 OpenAI SDK，再把等待逻辑拆到轮询步骤即可避免超时。参考媒体最多支持 9 张图片、3 段视频与 3 条音轨，单段片段最长 15 秒。

方案一：轮询模式的超时设置步骤

轮询模式的关键是给提交请求设置短超时，给整体任务设置长超时。具体步骤如下：

1. 对 POST /v1/video/generations 设置较短的请求超时（如连接与读超时各数十秒），仅用于拿到 task_id。
2. 循环调用 GET /v1/video/generations/{task_id}，每次请求本身也用短超时。
3. 在轮询循环外设置整体等待上限（业务侧的 deadline），而非依赖单次 HTTP 超时。
4. 当 status 变为 succeeded 时读取结果中的视频 url；为 failed 时按错误处理。
5. 在每次轮询之间加入间隔，避免过于频繁请求。

这样即使生成耗时较长，单个 HTTP 连接也不会被拉爆。

方案二：Webhook 回调，避免长时间轮询

Webhook 模式可以完全消除客户端长连接等待。做法是在提交任务时设置 metadata.callback_url，任务到达最终状态后，结果会被 POST 到你的服务器，你的接收端点解析视频 url 即可。此模式下提交请求同样只需短超时拿到 task_id，后续不再需要持续轮询。鉴权使用 Authorization: Bearer YOUR_API_KEY，密钥可在 https://relaydance.com/console 创建。参考媒体放入 metadata.content[]，并在 prompt 中以 @image1 到 @imageN 引用；提交参数包含 model、prompt、seconds 及 metadata（如 ratio、resolution、generate_audio）。

超时导致失败会不会扣费：计费说明

失败或报错的请求不会产生费用，因此重试因超时中断的任务时无需担心重复计费。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」。RelayDance 采用按生成量计费，具体单价见 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 卡。

常见问题 FAQ

问：单个请求等待视频结果时超时怎么办？

不要在提交请求上等待结果。提交后拿到 task_id，改用 GET /v1/video/generations/{task_id} 轮询，或设置 metadata.callback_url 使用 Webhook 回调。

问：因超时中断的请求会被计费吗？

不会。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，计费按实际生成量结算。

问：切换到 RelayDance 需要改多少代码？

接口为 OpenAI 兼容，据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，再把等待逻辑改为轮询或 Webhook 即可。