火山方舟
火山方舟
API参考
请输入
- 文档首页
火山方舟视频生成 API取消或删除视频生成任务
复制全文
下载 pdf取消或删除视频生成任务
文档反馈
问问助手DELETE https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/{id}
取消排队中的视频生成任务，或者删除视频生成任务记录。
鉴权
- 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 为空对象 {}。
默认
发起调试等同于请求真实调用，可能产生云产品费用，请谨慎操作！
Request
cURL
TASK_ID="your_task_id"
curl -X DELETE "https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/$TASK_ID" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ARK_API_KEY"Response
{}最近更新时间：2026.10.30 16:10:32
这个页面对您有帮助吗？
有用
有用
无用
无用