取消或删除视频生成任务

文档版本：v1.0.0 | 最后更新：2026-06-11
本平台已完整适配豆包 Seedance 系列官方视频生成接口，请求与响应均为透传，参数语义与官方一致。

取消或删除指定的视频生成任务。根据任务当前状态，执行不同操作。

DELETE https://platform.shuyanai.com/seedance/api/v3/contents/generations/tasks/{id}

请求参数

参数	类型	必填	说明
`id`	string	是	视频生成任务 ID。由创建视频生成任务接口返回。

头部	必填	说明
`Authorization`	是	`Bearer {API_KEY}`

调用 DELETE 接口时，根据任务当前状态，执行不同操作：

任务当前状态	执行操作	说明
`queued`（排队中）	取消任务	任务状态变为 `cancelled`，不再排队执行。取消状态 24h 自动删除。
`running`（生成中）	取消任务	任务状态变为 `cancelled`，终止正在进行的生成。取消状态 24h 自动删除。
`succeeded`（生成成功）	删除任务	任务记录被删除，视频 URL 失效，不可再查询。
`failed`（生成失败）	删除任务	任务记录被删除，不可再查询。
`cancelled`（已取消）	删除任务	任务记录被删除，不可再查询。
`expired`（已过期）	删除任务	任务记录被删除，不可再查询。

注意：
取消操作不保证立即生效。如果任务已进入生成的最终阶段，可能仍会完成生成。
已取消的任务（cancelled）在取消后 24 小时自动删除，无需手动调用删除。
删除操作不可逆。删除后任务 ID 不可再查询，视频下载链接（如有）也将失效。

请求成功时返回空响应体，HTTP 状态码为 200。

HTTP/1.1 200 OK

（响应体为空）