常见问题

应该多久查询一次任务？

建议每 3 到 5 秒查询一次，并对 429 和临时 5xx 使用指数退避。不要每秒高频轮询。

为什么创建成功后没有视频 URL？

创建接口只确认异步任务已经受理。视频 URL 只会在任务完成后出现在查询响应中。

completed 后怎样下载？

优先读取查询响应中的 result_url 或 metadata.url。OpenAI 协议也可请求 GET /v1/videos/{task_id}/content，并将响应按二进制流保存。

可以直接上传本地文件吗？

两套 Seedance 视频路径都只接受 URL 形式的媒体引用，multipart 文件字段会被拒绝。先将文件上传到可访问位置，或使用 Ark 素材库创建素材并等待其变为 Active，再将返回 URL 放入 metadata.content。

为什么同一个任务在两个查询接口中的结构不同？

这是协议兼容设计。/v1/video/generations/{task_id} 返回 { code, data } 包装；/v1/videos/{task_id} 返回顶层 OpenAI 视频对象。客户端应固定使用创建时对应的查询协议。

结果 URL 可以永久使用吗？

不保证。结果可能是有有效期的签名地址。需要长期保存时，请在任务完成后及时转存。