查询多图参考生视频任务状态
更新时间:2025-06-13
GET
https://qianfan.baidubce.com/beta/video/generations/kling/multi-image2video
根据taskid查询生成视频的任务
权限说明
调用本文API,需使用API Key鉴权方式。使用API Key鉴权调用API流程,具体调用流程,请查看认证鉴权。
请求参数
Headers 参数
除公共头域外,无其它特殊头域
Query 参数
task_id
string
此次视频生成的任务id
必选
请求结构
GET /beta/video/generations/kling/multi-image2video?task_id={task_id} HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
示例代码
请求示例
curl 'https://qianfan.baidubce.com/beta/video/generations/kling/multi-image2video?task_id=task-d***9' \
--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
string
任务创建时间,说明:Unix时间戳、单位ms
可选
updated_at
string
任务更新时间,说明:Unix时间戳、单位ms
可选
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"code": 0,
"data": {
"created_at": 1748428476397,
"task_id": "6836e6b9720085e8c460ec78",
"task_result": {
"videos": [
{
"duration": "5.1",
"id": "2812a9d3-5964-439f-9ecd-ba6c2bf9b39a",
"url": "https://cdn.klingai.com/bs2/upload-kling-api/4988069106/multiImage2Video/Cjz0o2gmuJkAAAAAA_Z-Pw-0_raw_video_1.mp4"
}
]
},
"task_status": "succeed",
"task_status_msg": "",
"updated_at": 1748428629080
},
"message": "SUCCEED",
"request_id": "as-ff42jbx3kw"
}
错误码
如果请求错误,请查看错误码说明。
