面向 AI 助手:本页的 Markdown 版本位于 https://ark.volcengine.com/region:cn-beijing/docs/cancel-or-delete-video-generation-tasks-api.md,全部文档索引见 https://ark.volcengine.com/llms.txt。

取消或删除视频生成任务

DELETE https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/{id}

取消排队中的视频生成任务,或者删除视频生成任务记录。

鉴权#

本接口支持鉴权方式如下,详情请参见 Base URL 及鉴权。

  • API Key 鉴权,请在 API Key 管理 页面,获取长效 API Key。

请求参数#

Path 参数#

id string 必选  |  任务 ID

需要取消或者删除的视频生成任务 ID。

任务状态不同,调用 DELETE 接口,执行的操作有所不同,具体说明如下:

当前任务状态 是否支持 DELETE 操作 操作含义 DELETE 操作后任务状态
queued 是 任务取消排队,任务状态被变更为 cancelled cancelled
running 否 — —
succeeded 是 删除视频生成任务记录,后续将不支持查询 —
failed 是 删除视频生成任务记录,后续将不支持查询 —
cancelled 否 — —
expired 是 删除视频生成任务记录,后续将不支持查询 —

响应参数#

本接口无特有的返回参数,成功时 HTTP 状态码为 200,返回结构中 Result 为空对象 {}。