查询视频特效生成任务状态
更新时间：2025-06-13
GET
https://qianfan.baidubce.com/beta/video/generations/kling/effects
根据taskid查询生成视频的任务
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
task_id
string
此次视频生成的任务id
必选
请求结构
GET /beta/video/generations/kling/effects?task_id={task_id} HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
示例代码
请求示例
curl 'https://qianfan.baidubce.com/beta/video/generations/kling/effects?task_id=task-***dbk9' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer bce-v3/ALTAK-*********/614fb**********' \
返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
code
integer
错误码，具体定义见错误码
可选
message
string
错误信息
可选
request_id
string
请求ID，系统生成，用于跟踪请求、排查问题
可选
data
object {7}
可选
显示子属性
隐藏子属性
task_id
string
任务ID，系统生成
可选
task_status
string
任务状态，说明：
· submitted：已提交
· processing：处理中
· succeed：成功
· failed：失败
可选
task_status_msg
string
任务状态信息，当任务失败时展示失败原因
可选
task_info
object {1}
可选
显示子属性
隐藏子属性
external_task_id
string
客户自定义任务ID
可选
task_result
object {1}
任务结果
可选
显示子属性
隐藏子属性
videos
array
视频信息
可选
显示子属性
隐藏子属性
items
object {3}
显示子属性
隐藏子属性
id
string
生成的视频ID；全局唯一
可选
url
string
生成视频的URL，注意：为保障信息安全，生成的图片/视频会在30天后被清理，请及时转存
可选
duration
string
视频总时长，单位s
可选
created_at
integer
任务创建时间，说明：Unix时间戳、单位ms
可选
updated_at
integer
任务更新时间，说明：Unix时间戳、单位ms
可选
响应示例
{
"code": 0,
"data": {
"created_at": 1739438734000,
"task_id": "67adba8e5b5ab6927a33478e",
"task_result": {
"videos": [
{
"id": "123***",
"url": "https://***",
"duration": "***"
}
]
},
"task_status": "processing",
"task_status_msg": "",
"updated_at": 1739438736000
},
"message": "SUCCEED",
"request_id": "as-vi***sj"
}错误码
如果请求错误，请查看错误码说明。