百度文库AI绘本
更新时间：2026-04-01
概要
用户可通过该接口输入故事文本，生成对应的绘本内容，支持静态绘本与动态绘本两种形式。该组件为付费功能，具体计费说明请参见使用文档
1、AI绘本创建任务
用户可通过该接口输入故事文本，创建AI绘本任务
接口定义
| URL | https://qianfan.baidubce.com/v2/tools/ai_picture_book/task_create |
|---|---|
| Method | POST |
Headers
| 字段 | 值 |
|---|---|
| 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：需输入故事内容 |
请求示例
Plain Text
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，创建任务的唯一标识，用于查询结果 |
响应示例
Plain Text
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绘本查询任务
用户可通过该接口查询生成的绘本故事
接口定义
| URL | https://qianfan.baidubce.com/v2/tools/ai_picture_book/query |
|---|---|
| Method | POST |
Headers
| 字段 | 值 |
|---|---|
| Authorization | Bearer {ApiKey} |
| Content-Type | application/json |
| X-Appbuilder-Request-Id | 非必填项（建议填写，方便后续链路问题排查，UUID格式） |
请求参数定义
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| task_ids | string[] | 是 | AI绘本任务的ID列表 |
请求示例
Plain Text
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 分发地址 |
响应示例
Plain Text
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 | 否 | 异常详情信息 |
评价此篇文章