AI绘本

更新时间：2025-10-27

概要

用户可通过该接口输入故事文本，生成对应的绘本内容，支持静态绘本与动态绘本两种形式。该组件为付费功能，具体计费说明请参见使用文档

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：需输入故事内容

请求示例

curl --request POST \
  --url https://qianfan.baidubce.com/v2/tools/ai_picture_book/task_create \
  --header 'Authorization: Bearer xxxxxx' \
  --header 'content-type: application/json' \
  --data '{
    "method": 9,
    "input_type": "1",
    "input_content": "活动乱跳的恶搞猫咪"
}'

响应参数

正确响应

字段	是否必填	说明
errno	是	成功的
requestId	是	请求ID
show_msg	是	异常信息
server_time	是	服务器时间秒
data	是	返回结果
+task_id	是	任务ID，创建任务的唯一标识，用于查询结果

响应示例

{
    "data": {
        "task_id": "24ac283e-def1-404b-8ca3-51eaf2d5d251"
    },
    "errno": 0,
    "server_time": 1753880287,
    "show_msg": "",
    "requestId": ""
}

错误响应

字段	类型	是否必填	说明
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列表

请求示例

curl --request POST \
  --url https://qianfan.baidubce.com/v2/tools/ai_picture_book/query \
  --header 'Authorization: Bearer xxxxxx' \
  --header 'content-type: application/json' \
  --data '{
    "task_ids": ["824b65fa-a8eb-401a-8f1c-a6d7384cae44"]
}'

响应参数

正确响应

字段	类型	是否必填	说明
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 分发地址

响应示例

{
    "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": ""
}

错误响应

字段	类型	是否必填	说明
requestId	str	是	请求ID
code	str	否	0 表示成功，其他都是异常
message	str	否	错误消息
detail		否	异常详情信息

教育培训

创建组件