查询文生视频生成任务列表
更新时间：2025-06-13
GET
https://qianfan.baidubce.com/beta/video/generations/kling/text2video/list
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
pageNum
integer
页码，取值范围：[1,1000]
可选
pageSize
integer
每页数据量，取值范围：[1,500]
可选
modelName
string
查询的modelName，不传默认为kling 1.6
可选
请求结构
GET /beta/video/generations/kling/text2video/list?pageNum={pageNum}&pageSize={pageSize} HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
示例代码
请求示例
curl 'https://qianfan.baidubce.com/beta/video/generations/kling/text2video/list?pageNum=1&pageSize=30' \
--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
string
任务更新时间，说明：Unix时间戳、单位ms
可选
响应示例
{
"code": 0,
"message": "SUCCEED",
"request_id": "as-j0drtyrxhm",
"data": [
{
"created_at": 1739438734000,
"task_id": "67adba8e5b5ab6927a33478e",
"task_result": {
"videos": []
},
"task_status": "processing",
"task_status_msg": "",
"updated_at": 1739438736000
},
{
"created_at": 1739437661211,
"task_id": "67adb65b5b5ab6927a334788",
"task_result": {
"videos": [
{
"duration": "5.354",
"id": "eac744da-46e8-4131-bde0-68db1757de6b",
"url": "https://cdn.kling***"
}
]
},
"task_status": "succeed",
"task_status_msg": "",
"updated_at": 1739437848760
}
]
}错误码
如果请求错误，请查看错误码说明。