取消视频生成任务
更新时间：2025-10-30
使用本接口，取消视频生成任务。
DELETE
https://qianfan.baidubce.com/video/generations
根据task_id取消视频生成任务。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
task_id
string
视频生成任务task_id。
注意：只支持取消未开始处理的任务，正在处理或已完成处理的任务不支持取消。
必选
请求结构
GET /video/generations?task_id={task_id} HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string示例代码
请求示例
curl -X DELETE 'https://qianfan.baidubce.com/video/generations?task_id=xq***k9' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer bce-v3/ALTAK-*********/614fb**********' 返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
field
string
本次请求的唯一标识，可用于排查问题。
可选
task_id
string
已取消的视频生成任务task_id。
可选
status
string
任务状态，任务成功取消后的状态变更为Terminated。
可选
响应示例
{
"id": "as-xxx",
"task_id": "68xxx00",
"status": "Terminated"
}错误码
如果调用失败并返回报错信息，请参见错误码进行解决。
公共错误码：查看公共错误码
本接口专有错误码如下：
| http状态码 | type | code | message |
|---|---|---|---|
| 500 | internal_error | video_generation_internal_error | video generation service internal error |
| 400 | invalid_request_error | invalid_video_generation_argument | xxx |
| 429 | rate_limit_exceeded | video_generation_concurrency_exceeded | Rate limit reached for Concurrency |
| 403 | unsafe_request | video_generation_prompt_unsafe | The input image/prompt is unsafe. |
| 403 | unsafe_request | video_generation_output_unsafe | The output is unsafe. |
| 501 | internal_error | video_generation_risk_system_error | risk control system internal error |