AI绘本
概要
用户可通过该接口输入故事文本,生成对应的绘本内容,支持静态绘本与动态绘本两种形式。该组件为付费功能,具体计费说明请参见使用文档
1、AI绘本创建任务
用户可通过该接口输入故事文本,创建AI绘本任务
接口定义
| 字段 |
值 |
| Authorization |
Bearer {ApiKey} |
| Content-Type |
application/json |
| X-Appbuilder-Request-Id |
非必填项(建议填写,方便后续链路问题排查,UUID格式) |
请求参数定义
| 字段 |
类型 |
是否必填 |
说明 |
| method |
int |
是 |
任务类型,9:制作静态绘本;10:制作动态绘本 |
| input_type |
string |
是 |
输入类型 1:根据输入的故事内容,生成故事脚本。 |
| input_content |
string |
是 |
输入内容,需结合input_type参数输入内容 当input_type = 1:需输入故事内容 |
请求示例
1curl --request POST \
2 --url https://qianfan.baidubce.com/v2/tools/ai_picture_book/task_create \
3 --header 'Authorization: Bearer xxxxxx' \
4 --header 'content-type: application/json' \
5 --data '{
6 "method": 9,
7 "input_type": "1",
8 "input_content": "活动乱跳的恶搞猫咪"
9}'
响应参数
正确响应
| 字段 |
是否必填 |
说明 |
| errno |
是 |
成功的 |
| requestId |
是 |
请求ID |
| show_msg |
是 |
异常信息 |
| server_time |
是 |
服务器时间秒 |
| data |
是 |
返回结果 |
| +task_id |
是 |
任务ID,创建任务的唯一标识,用于查询结果 |
响应示例
1{
2 "data": {
3 "task_id": "24ac283e-def1-404b-8ca3-51eaf2d5d251"
4 },
5 "errno": 0,
6 "server_time": 1753880287,
7 "show_msg": "",
8 "requestId": ""
9}
错误响应
| 字段 |
类型 |
是否必填 |
说明 |
| requestId |
str |
是 |
请求ID |
| code |
str |
否 |
0 表示成功,其他都是异常 |
| message |
str |
否 |
错误消息 |
| detail |
|
否 |
异常详情信息 |
2、AI绘本查询任务
用户可通过该接口查询生成的绘本故事
接口定义
| 字段 |
值 |
| Authorization |
Bearer {ApiKey} |
| Content-Type |
application/json |
| X-Appbuilder-Request-Id |
非必填项(建议填写,方便后续链路问题排查,UUID格式) |
请求参数定义
| 字段 |
类型 |
是否必填 |
说明 |
| task_ids |
string[] |
是 |
AI绘本任务的ID列表 |
请求示例
1curl --request POST \
2 --url https://qianfan.baidubce.com/v2/tools/ai_picture_book/query \
3 --header 'Authorization: Bearer xxxxxx' \
4 --header 'content-type: application/json' \
5 --data '{
6 "task_ids": ["824b65fa-a8eb-401a-8f1c-a6d7384cae44"]
7}'
响应参数
正确响应
| 字段 |
类型 |
是否必填 |
说明 |
| errno |
int |
是 |
错误码,正常响应返回0 |
| requestId |
str |
是 |
请求ID |
| show_msg |
str |
是 |
异常信息 |
| server_time |
int |
是 |
服务器时间秒 |
| data |
TaskResult |
是 |
查询任务结果列表 |
TaskResult对象
| 字段 |
类型 |
是否必填 |
说明 |
| task_id |
string |
是 |
任务ID |
| status |
int |
是 |
任务状态,0:待启动;1:运行中;2:全部完成;3:部分完成;4:失败 |
| result |
string |
否 |
任务运行结果JSON字符串,具体参考result结构 |
result结构
| 参数名 |
参数类型 |
参数说明 |
| video_bos_url |
string |
BOS 存储地址(直链) |
| video_cdn_url |
string |
CDN 分发地址 |
响应示例
1{
2 "errno": 0,
3 "show_msg": "",
4 "server_time": 1760322950,
5 "data": [
6 {
7 "task_id": "9e5ef939-0262-4ed3-9538-5e612b132ad7",
8 "status": 2,
9 "result": {
10 "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",
11 "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"
12 }
13 }
14 ],
15 "requestId": ""
16}
错误响应
| 字段 |
类型 |
是否必填 |
说明 |
| requestId |
str |
是 |
请求ID |
| code |
str |
否 |
0 表示成功,其他都是异常 |
| message |
str |
否 |
错误消息 |
| detail |
|
否 |
异常详情信息 |
![]()