查询AI绘本任务
更新时间：2026-05-07
POST
https://qianfan.baidubce.com/v2/tools/ai_picture_book/query
本接口用于查询AI绘本生成任务状态及结果，返回任务运行状态和视频地址等关键信息。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
task_ids
array
AI绘本任务的ID列表。
必选
显示子属性
隐藏子属性
items
string
请求结构
POST /v2/tools/ai_picture_book/query HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"task_ids": ["824b65fa-a8eb-401a-8f1c-a6d7384cae44"]
}示例代码
基础调用
curl -X POST "https://qianfan.baidubce.com/v2/tools/ai_picture_book/query" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: application/json" \
-d '{
"task_ids": ["824b65fa-a8eb-401a-8f1c-a6d7384cae44"]
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
errno
integer
错误码，正常响应返回 0。
可选
requestId
string
请求ID。
可选
show_msg
string
异常信息。
可选
server_time
integer
服务器时间，单位为秒。
可选
data
array
查询任务结果列表。
可选
显示子属性
隐藏子属性
items
object {3}
显示子属性
隐藏子属性
task_id
string
任务ID。
可选
status
integer
任务状态。可选值：0（待启动）、1（运行中）、2（全部完成）、3（部分完成）、4（失败）。
可选
result
object {2}
任务运行结果，具体参考 result 结构。
可选
显示子属性
隐藏子属性
video_bos_url
string
BOS 存储地址（直链）。
可选
video_cdn_url
string
CDN 分发地址。
可选
成功示例
{
"errno": 0,
"show_msg": "",
"server_time": 1760322950,
"data": [
{
"task_id": "9e5ef939-0262-4ed3-9538-5e612b132ad7",
"status": 2,
"result": {
"video_bos_url": "https://wenku-huiben.bj.bcebos.com/6620137974448413217/video/vd.mp4?authorization=bce-auth-v1%2Ffa1126e91489401fa7cc85045ce7179e%2F2025-10-13T02%3A33%3A14Z%2F-1%2Fhost%2F1d19703befc0483c9237c815804b33b4ccf28d836961839735cc41b941fcd6ec",
"video_cdn_url": "https://wenku-huiben.cdn.bcebos.com/6620137974448413217/video/vd.mp4?authorization=bce-auth-v1%2Ffa1126e91489401fa7cc85045ce7179e%2F2025-10-13T02%3A33%3A14Z%2F-1%2Fhost%2Fca5786310eea5175047d24341d96e456d97020caf2e15cc0d78eb4614901f8bd"
}
}
],
"requestId": ""
}评价此篇文章