视频结果链接失效打不开：正确下载并长期保存 Seedance 输出

视频结果链接失效打不开时，正确做法是：轮询 GET /v1/video/generations/{task_id} 直到 status 为 succeeded，立即从返回结果中取出 video url 并下载到自有存储，不要长期依赖临时链接。也可在提交任务时设置 metadata.callback_url，由 RelayDance 将最终状态 POST 到你的服务器，实现自动接收与落盘保存。计费为按生成结果的 pay-as-you-go，失败请求不产生费用。

为什么结果链接会失效

结果链接失效通常是因为它是任务完成后返回的临时地址，需要及时下载并转存到你自己的存储中。提交视频任务后，通过 GET /v1/video/generations/{task_id} 轮询，直到 status 变为 succeeded 或 failed；succeeded 时返回结果包含 video url。你应在拿到该 url 后立即下载文件，而非在数据库中保存链接本身。RelayDance 采用 OpenAI 兼容协议，据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，因此轮询与下载可复用现有 SDK 流程，无需额外改造。

正确的下载与长期保存步骤

正确保存 Seedance 输出的方式是在任务成功后立刻下载 video url 并写入持久化存储。可按以下步骤操作：

1. 使用 Authorization: Bearer YOUR_API_KEY 提交 POST /v1/video/generations，携带 model、prompt、seconds 等参数（API Key 在 https://relaydance.com/console 创建）。
2. 轮询 GET /v1/video/generations/{task_id}，直到 status 为 succeeded 或 failed。
3. status 为 succeeded 时，从结果读取 video url。
4. 立即下载 video url 的文件，写入你自己的对象存储或数据库。
5. 只保留自有存储的地址，不长期依赖返回的临时链接。

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

用 Webhook 自动接收结果

使用 Webhook 可以避免轮询并在结果生成后自动落盘保存。在提交任务时设置 metadata.callback_url，RelayDance 会在任务进入最终状态时将结果 POST 到你的服务器，你的服务在收到回调后即可直接下载 video url 并转存。这种模式减少了对链接有效期的依赖，也降低了因未及时轮询而错过下载窗口的风险。参考媒体放在 metadata.content[] 中，并在 prompt 里以 @image1 到 @imageN 的形式引用。图像生成走 POST /v1/images/generations，同样返回可下载的结果地址。

计费与常见价格参考

计费为按生成结果的 pay-as-you-go，反复下载已完成的视频不会重复扣费，失败请求也不计费。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，因此轮询到 failed 状态时你无需担心成本。以下为部分参考价格（来源 relaydance.com/models）：

各模型实时费率见 https://relaydance.com/models，接口文档见 https://relaydance.com/docs。

FAQ

问：链接打不开是否说明我被扣了费却拿不到视频？

答：不是。计费按生成结果 pay-as-you-go，链接失效只是临时地址过期，你可重新轮询 GET /v1/video/generations/{task_id} 获取结果并重新下载；据 relaydance.com 官方文档，「失败或报错的请求一律不计费」。

问：如何避免每次都手动检查任务状态？

答：在提交任务时设置 metadata.callback_url，最终状态会被 POST 到你的服务器，收到后自动下载并保存 video url。

问：接入是否需要改动现有 OpenAI 代码？

答：改动很小。据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，无需 BytePlus 企业账号或 KYC。