查询图生视频生成任务状态
更新时间：2025-06-13
GET
https://qianfan.baidubce.com/beta/video/generations/kling/image2video
根据taskid查询生成视频的任务
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
task_id
string
此次视频生成的任务id
必选
请求结构
GET /beta/video/generations/kling/image2video?task_id={task_id} HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
示例代码
请求示例
curl 'https://qianfan.baidubce.com/beta/video/generations/kling/image2video?task_id=task-d***k9' \
--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": 1739439448000,
"task_id": "67adbd585b5ab6927a334790",
"task_result": {
"videos": []
},
"task_status": "processing",
"task_status_msg": "",
"updated_at": 1739439450000
},
"message": "",
"request_id": "as-vrd1z6v0xc"
}错误码
如果请求错误，请查看错误码说明。