Seedance 2.0
删除视频生成任务
本文介绍删除视频生成任务 API 的输入输出参数，供您使用接口时查阅字段含义。删除一个已进入终态的任务，删除后该任务不可再查询。
可删除的状态
只有已进入终态的任务可以删除：succeeded、failed、cancelled、expired。其他状态返回 403 OperationDenied.InvalidState，响应的 error.reasonCode 补充说明拒绝原因。
要清理尚在排队的任务，先取消，等 status 变为 cancelled 后再删除。
删除的影响
- 该任务不再可以查询。
- 删除前已经取得的
content.video_url在其有效期内仍然可用，有效期见该任务的content.expiredAt。
删除不可撤销。需要长期保存视频的，请在删除前完成转存。
响应字段
200 返回被删除任务的存档信息：
| 字段 | 说明 |
|---|---|
taskId | 被删除的任务 ID |
deletedAt | 删除时间，RFC3339 格式 |
deletedBy | 执行删除操作的成员 ID |
deleteReason | 删除原因 |
接口详情
授权
BearerAuth Authorization<token>
需要鉴权的接口请传入 Bearer <token> 形式的访问令牌。
位置: header
路径参数
id*string
任务 ID
响应主体
application/json
application/json
application/json
application/json
application/json
application/json
application/json
在线请求
「发送」会向所选服务器地址发起真实调用，与生产环境请求等效，可能产生计费。
请求示例
curl -X DELETE "https://example.com/api/v3/contents/generations/tasks/string"响应示例
{ "deleteReason": "user_deleted", "deletedAt": "2026-05-19T12:00:00Z", "deletedBy": "membership_01hxy8v7m9n0pqrstuvwxyza1", "taskId": "task_019db400-0000-7000-8000-000000000001"}{ "error": { "code": "InvalidParameter", "message": "The parameter content specified in the request is not valid. Request id: 0217790892668142434549f79b621a35", "param": "content", "reasonCode": "seedance_text_blocked_by_moderation", "requestId": "seedance_req_019e8808-d40e-7ccd-873c-072b78b15437", "type": "BadRequest" }}{ "error": { "code": "InvalidParameter", "message": "The parameter content specified in the request is not valid. Request id: 0217790892668142434549f79b621a35", "param": "content", "reasonCode": "seedance_text_blocked_by_moderation", "requestId": "seedance_req_019e8808-d40e-7ccd-873c-072b78b15437", "type": "BadRequest" }}{ "error": { "code": "InvalidParameter", "message": "The parameter content specified in the request is not valid. Request id: 0217790892668142434549f79b621a35", "param": "content", "reasonCode": "seedance_text_blocked_by_moderation", "requestId": "seedance_req_019e8808-d40e-7ccd-873c-072b78b15437", "type": "BadRequest" }}{ "error": { "code": "InvalidParameter", "message": "The parameter content specified in the request is not valid. Request id: 0217790892668142434549f79b621a35", "param": "content", "reasonCode": "seedance_text_blocked_by_moderation", "requestId": "seedance_req_019e8808-d40e-7ccd-873c-072b78b15437", "type": "BadRequest" }}{ "error": { "code": "InvalidParameter", "message": "The parameter content specified in the request is not valid. Request id: 0217790892668142434549f79b621a35", "param": "content", "reasonCode": "seedance_text_blocked_by_moderation", "requestId": "seedance_req_019e8808-d40e-7ccd-873c-072b78b15437", "type": "BadRequest" }}{ "error": { "code": "InvalidParameter", "message": "The parameter content specified in the request is not valid. Request id: 0217790892668142434549f79b621a35", "param": "content", "reasonCode": "seedance_text_blocked_by_moderation", "requestId": "seedance_req_019e8808-d40e-7ccd-873c-072b78b15437", "type": "BadRequest" }}