# 删除视频生成任务

URL: http://localhost:3000/docs/zh-cn/api/deleteSeedanceTask

本文介绍删除视频生成任务 API 的输入输出参数，供您使用接口时查阅字段含义。删除一个已进入终态的任务，删除后该任务不可再查询。



## 可删除的状态 [#可删除的状态]

只有已进入终态的任务可以删除：`succeeded`、`failed`、`cancelled`、`expired`。其他状态返回 `403 OperationDenied.InvalidState`，响应的 `error.reasonCode` 补充说明拒绝原因。

要清理尚在排队的任务，先[取消](/zh-cn/api/cancelSeedanceTask)，等 `status` 变为 `cancelled` 后再删除。

## 删除的影响 [#删除的影响]

* 该任务不再可以[查询](/zh-cn/api/getSeedanceTask)。
* 删除前已经取得的 `content.video_url` 在其有效期内仍然可用，有效期见该任务的 `content.expiredAt`。

删除不可撤销。需要长期保存视频的，请在删除前完成转存。

## 响应字段 [#响应字段]

`200` 返回被删除任务的存档信息：

| 字段             | 说明              |
| -------------- | --------------- |
| `taskId`       | 被删除的任务 ID       |
| `deletedAt`    | 删除时间，RFC3339 格式 |
| `deletedBy`    | 执行删除操作的成员 ID    |
| `deleteReason` | 删除原因            |

## 接口详情 [#接口详情]

<OpenAPIPage document="public" operations="[{&#x22;path&#x22;:&#x22;/api/v3/contents/generations/tasks/{id}&#x22;,&#x22;method&#x22;:&#x22;delete&#x22;}]" />

## 常见问题 [#常见问题]

### 删除返回 403 OperationDenied.InvalidState [#删除返回-403-operationdeniedinvalidstate]

任务尚未进入终态。先[查询任务](/zh-cn/api/getSeedanceTask)确认 `status`：排队中的任务可以先[取消](/zh-cn/api/cancelSeedanceTask)，生成中的任务只能等待其进入终态。


---

本页对应接口：`DELETE /api/v3/contents/generations/tasks/{id}`。机器可读的完整 schema：

- 本接口 schema：http://localhost:3000/docs/openapi/operations/deleteSeedanceTask.zh.json
- 完整对外 spec（供代码生成工具使用）：http://localhost:3000/docs/openapi/public.zh.json