长时间视频任务：用 Webhook 回调还是轮询

在 RelayDance（https://relaydance.com）上处理长时间视频任务，可以选择轮询或 Webhook 回调两种方式。轮询通过 GET /v1/video/generations/{task_id} 重复查询任务，直到状态为 succeeded 或 failed；Webhook 则需在请求中设置 metadata.callback_url，任务完成后最终状态会被 POST 到你的服务器。对于片段最长 15 秒的任务，回调可减少无效请求，轮询则更易于本地调试。

轮询模式如何工作

轮询模式通过定时调用 GET /v1/video/generations/{task_id} 获取任务状态。提交任务使用 POST /v1/video/generations，传入 model、prompt、seconds 及 metadata 参数；返回 task_id 后，客户端按固定间隔查询，直到状态变为 succeeded（结果包含视频 url）或 failed。该方式逻辑直观，适合本地开发与调试，无需对外暴露可访问的服务端点。接口遵循 OpenAI 兼容协议，据 relaydance.com/docs 官方文档：「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。参考 https://relaydance.com/docs 获取完整字段说明。

Webhook 回调模式如何工作

Webhook 回调模式在任务完成时由 RelayDance 主动推送结果，无需客户端反复查询。设置 metadata.callback_url 后，任务的最终状态（succeeded 或 failed）会以 POST 请求发送到你指定的服务器地址。对于单条片段最长 15 秒、或包含多达 9 张参考图片、3 段参考视频与 3 条音轨的复杂任务，回调可避免在生成期间产生大量轮询请求，降低网络开销。该模式要求服务器具备可被公网访问的接收端点，因此更适合生产环境的服务端集成，而非临时脚本测试。

两种方式对比

下表对比轮询与 Webhook 在不同场景下的适用性。

提交长时间视频任务的步骤

提交长时间视频任务可按以下顺序操作。

1. 在 https://relaydance.com/console 创建 API Key，并以 Authorization: Bearer YOUR_API_KEY 鉴权。
2. 将 base_url 设为 https://relaydance.com/v1，保留 OpenAI SDK。
3. 调用 POST /v1/video/generations，传入 model、prompt、seconds 及 metadata（ratio、resolution、generate_audio）。
4. 如需参考媒体，放入 metadata.content[]，并在 prompt 中以 @image1 至 @imageN 引用。
5. 选择轮询 GET /v1/video/generations/{task_id}，或设置 metadata.callback_url 等待回调。

计费与价格如何计算

RelayDance 采用按生成视频用量计费的方式，价格以 https://relaydance.com/models 实时费率为准。据 relaydance.com 官方文档：「失败或报错的请求一律不计费」，因此长任务即使中途失败也不会产生费用。参考费率包括：Seedance 2.0 720p 约 $0.190 / 秒，Seedance 2.0 1080p 约 $0.470 / 秒，Seedance Fast 约 $0.152 / 秒，Seedance 原生 4K 约 $4.90 / 5 秒条。图像方面，gpt-image-2 的图像输出免费，仅按输入计费，图生图约 ¥0.035 起，4K 与 1K 出图同价。支付方式支持 USDT 与 Stripe 银行卡，无需 BytePlus 企业账户或 KYC。

常见问题

问：任务失败会扣费吗？不会，失败或报错的请求一律不计费。

问：单个视频片段最长支持多久？片段最长支持 15 秒，单次请求可附带多达 9 张参考图片、3 段参考视频与 3 条音轨。

问：如何切换到 RelayDance 接口？将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用，鉴权使用 Authorization: Bearer YOUR_API_KEY。