# 取消视频生成任务

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

本文介绍取消视频生成任务 API 的输入输出参数，供您使用接口时查阅字段含义。取消一个尚在排队中的任务，使其不再进入生成阶段。



## 可取消的状态 [#可取消的状态]

只有 `queued`（排队中）的任务可以取消。其他状态返回 `403 OperationDenied.InvalidState`，响应的 `error.reasonCode` 补充说明拒绝原因。已经进入生成阶段（`running`）的任务无法取消。

## 取消不是立即生效的 [#取消不是立即生效的]

`200` 表示取消请求已被受理，任务不会在响应返回的同时变为 `cancelled`。最终状态以[查询任务](/zh-cn/api/getSeedanceTask)返回的 `status`，或 `callback_url` 收到的通知为准。

响应结构与查询任务一致。

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

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

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

### 取消返回 403 OperationDenied.InvalidState [#取消返回-403-operationdeniedinvalidstate]

任务已不在 `queued` 状态——通常是已经开始生成（`running`），或已经进入终态。先[查询任务](/zh-cn/api/getSeedanceTask)确认当前 `status`：已进入生成阶段的任务无法取消，只能等待其进入终态。

### 取消成功后如何清理任务 [#取消成功后如何清理任务]

任务转为 `cancelled` 后即进入终态，可以[删除](/zh-cn/api/deleteSeedanceTask)。删除只接受终态任务，所以顺序是先取消、待 `status` 变为 `cancelled`、再删除。


---

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

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