取消或删除视频生成任务
火山文档原文DELETE /api/v3/contents/generations/tasks/{task_id}
Authorization
BearerAuth
AuthorizationBearer <token>
输入 API Token。请求将使用 Authorization: Bearer 。
In: header
Path Parameters
task_id*string
需要取消或删除的视频生成任务 ID
Response Body
application/json
application/json
curl -X DELETE "https://jieyun.cc/api/v3/contents/generations/tasks/cgt-2026-example"Empty
{
"error": {
"message": "string",
"type": "string",
"param": "string",
"code": "string"
}
}{
"error": {
"message": "string",
"type": "string",
"param": "string",
"code": "string"
}
}接口说明
根据任务当前状态取消排队任务，或删除已结束的任务记录。本文档已按火山引擎官方接口说明校对。
DELETE https://jieyun.cc/api/v3/contents/generations/tasks/{task_id}
Authorization: Bearer <API_KEY>删除不可恢复
删除任务记录后无法再次查询。需要保留生成视频时，请先下载或转存有效期为 24 小时的视频 URL。
请求参数
| Path 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
task_id | string | 是 | 需要取消或删除的视频生成任务 ID。 |
请求示例：
curl -X DELETE "https://jieyun.cc/api/v3/contents/generations/tasks/cgt-2026-example" \
-H "Authorization: Bearer <API_KEY>"状态与操作
| 当前状态 | 是否支持 | 处理结果 |
|---|---|---|
queued | 是 | 取消排队，任务状态变为 cancelled。 |
cancelled | 否 | 取消状态保留 24 小时后自动删除。 |
running | 否 | 运行中的任务不能取消或删除。 |
failed | 是 | 删除任务记录，之后无法查询。 |
succeeded | 是 | 删除任务记录，之后无法查询。 |
expired | 是 | 删除任务记录，之后无法查询。 |
响应内容
操作成功时不返回业务响应体。