AI作画-画面描述生成
更新时间：2024-10-16
接口描述
AI 作画-画面描述生成，可根据用户输入的文本，进行智能文本改写，生成主体人物对应形象和环境描述prompt。
- 提交请求：支持传入文本参数，创建 文本改写 任务，获得任务ID。
- 查询结果：用于在任务创建后，查看文本生成状态。
-
生成AI绘本的使用链路：
1.使用「画面描述生成API」，输入故事内容本身，可得到主体名和主体形象描述prompt、以及每句话对应画面场景和画面描述prompt。
2.使用「AI作画API」，输入步骤1中得到的主体形象描述prompt，可得到主体图。
3.使用「主体一致图像生成与调整API」，输入步骤2中得到的主体图、以及步骤1中得到的每句话对应的画面描述prompt，可得到单个画面场景的图片
画面描述生成-提交请求-接口说明
请求示例
HTTP方法: POST
请求URL: https://aip.baidubce.com/rpc/2.0/wenxin/v1/image/desc/gen
URL参数：
| 参数 | 值 |
|---|---|
| access_token | 通过API Key和Secret Key获取的access_token,参考“Access Token获取” |
Header如下：
| 参数 | 值 |
|---|---|
| Content-Type | application/json |
请求参数
POST 方式调用
注意：要求使用 JSON 格式的结构体来描述一个请求的具体内容。
| 参数 | 是否必选 | 类型 | 描述 |
|---|---|---|---|
| text | 是 | string | 画面文本描述 |
请求示例
{
"text": "在一个遥远的国度，有一片被绿色植被覆盖的森林，森林深处隐藏着一个神秘的湖泊。湖边住着一位美丽而善良的公主，名叫莉娜。有一天，莉娜在湖边散步时，忽然听到一阵微弱的呼救声。莉娜将青蛙从泥泞中救了出来。"
}返回说明
JSON 格式
注意：若输入为 UTF-8 编码（通过指定 charset 参数），则返回内容为 UTF-8 编码
返回参数
| 参数 | 类型 | 描述 |
|---|---|---|
| code | number | 错误码，请求成功为0 |
| msg | string | 错误信息 |
| data | object | 返回的数据 |
| +jobId | int | 任务id |
返回示例
{
"code": 0,
"data": {
"jobId": 1035
},
"msg": "ok"
}curl示例
curl --location 'http://10.163.171.23:8080/rpc/2.0/wenxin/v1/image/desc/gen?BIZ_VERSION=1&appid=1198' \
--header 'X-dev-origin-user-id: 4316051661' \
--header 'X-dev-user-account-type: charge' \
--header 'Content-Type: application/json' \
--data '{
"text": "在一个遥远的国度，有一片被绿色植被覆盖的森林，森林深处隐藏着一个神秘的湖泊。湖边住着一位美丽而善良的公主，名叫莉娜。有一天，莉娜在湖边散步时，忽然听到一阵微弱的呼救声。莉娜将青蛙从泥泞中救了出来。"
}'画面描述生成-查询结果-接口说明
请求示例
HTTP方法: POST
请求URL: https://aip.baidubce.com/rpc/2.0/wenxin/v1/image/desc/query
URL参数：
| 参数 | 值 |
|---|---|
| access_token | 通过API Key和Secret Key获取的access_token,参考“Access Token获取” |
Header如下：
| 参数 | 值 |
|---|---|
| Content-Type | application/json |
请求格式
POST 方式调用
注意：要求使用 JSON 格式的结构体来描述一个请求的具体内容。
请求参数
| 参数 | 是否必选 | 类型 | 描述 |
|---|---|---|---|
| jobId | 是 | string | 任务id |
请求示例
{
"jobId": 748
}返回格式
JSON 格式
返回参数
| 参数 | 类型 | 描述 |
|---|---|---|
| code | number | 错误码，请求成功为0 |
| msg | string | 错误信息 |
| data | object | 返回的数据 |
| +charactersId | string | 主体列表id |
| +characterList | object | 主体列表 |
| ++characterId | string | 主体id，用于标识单个主体 |
| ++characterDesc | string | 主体画面描述，可作为作画提示词使用 |
| ++characterName | string | 主体名称 |
| +screensId | string | 画面列表id |
| +screentList | object | |
| ++screenId | string | 画面id，用于标识单个画面 |
| ++imageDesc | string | 画面对应的描述，可作为作画提示词使用 |
| ++narration | string | 画面对应的文本，由“画面描述生成-提交请求”中的text参数拆分而来 |
| ++subScreenInfos | object | 子画面信息 |
| +++subScreenId | string | 子画面id |
| +++screenContent | string | 子画面内容 |
| +++characterList | string | 子画面角色 |
返回示例
{
"code": 200,
"msg": "",
"data": {
"characterList": [
{
"characterId": "7031558e-f92b-479d-92dc-c39efc4c2b93",
"characterDesc": "黄种人,女性,20岁,瓜子脸,金色长发,皮肤白皙,体型匀称",
"characterName": "莉娜"
},
{
"characterId": "f6a79839-6b06-42c6-9bca-a9867653968a",
"characterDesc": "一只绿色的青蛙,体型中等,眼睛大而突出,四肢短小",
"characterName": "青蛙"
}
],
"screentList": [
{
"screenId": "f0aca13f-65db-4d73-95af-be9751258e92",
"narration": "在一个遥远的国度,有一片被绿色植被覆盖的森林,森林深处隐藏着一个神秘的湖泊。",
"subScreenInfos": [
{
"subScreenId": "91d27d48-78ba-4866-bb1f-1af1bdeae97d",
"screenContent": "绿色的森林中,阳光透过树叶洒下斑驳的光影,远处隐约可见湖泊的轮廓",
"characterList": []
},
{
"subScreenId": "b2b1b888-39ac-429d-9ccd-056b9cfe6916",
"screenContent": "湖泊旁,清澈的水面映出周围的绿树和蓝天,水面上有几只白色的水鸟在嬉戏",
"characterList": []
}
]
},
{
"screenId": "a1b4586f-8c45-466a-8651-1907cb492dfc",
"narration": "湖边住着一位美丽而善良的公主,名叫莉娜。",
"subScreenInfos": [
{
"subScreenId": "7915b0c1-ad32-4634-a6f7-1da2c105b8fd",
"screenContent": "公主莉娜站在湖边,她穿着华丽的裙子,金色的长发随风飘动,她正专注地欣赏着湖中的景色",
"characterList": [
{
"characterId": "7031558e-f92b-479d-92dc-c39efc4c2b93",
"characterName": "莉娜"
}
]
}
]
},
{
"screenId": "01cce958-67fa-49aa-89ba-1e8388be69de",
"narration": "有一天,莉娜在湖边散步时,忽然听到一阵微弱的呼救声。",
"subScreenInfos": [
{
"subScreenId": "682527e8-b712-46e7-916e-8d51615934bd",
"screenContent": "莉娜在湖边散步,她突然停下脚步,眉头紧锁,似乎听到了什么异常的声音",
"characterList": [
{
"characterId": "7031558e-f92b-479d-92dc-c39efc4c2b93",
"characterName": "莉娜"
}
]
}
]
},
{
"screenId": "19ddacb7-d2ab-4705-8a4b-00ae5b058414",
"narration": "莉娜将青蛙从泥泞中救了出来。",
"subScreenInfos": [
{
"subScreenId": "4afcfdc7-8b4b-4261-a937-417588b38b0a",
"screenContent": "莉娜弯下腰,小心翼翼地将陷入泥泞中的青蛙救了出来,她的脸上露出了关切的表情",
"characterList": [
{
"characterId": "7031558e-f92b-479d-92dc-c39efc4c2b93",
"characterName": "莉娜"
},
{
"characterId": "f6a79839-6b06-42c6-9bca-a9867653968a",
"characterName": "青蛙"
}
]
},
{
"subScreenId": "b69e161c-a67b-4766-8bce-d0664b5ec9df",
"screenContent": "青蛙在莉娜的手中挣扎着,最终成功脱离泥泞,它的大眼睛中充满了感激",
"characterList": [
{
"characterId": "7031558e-f92b-479d-92dc-c39efc4c2b93",
"characterName": "莉娜"
},
{
"characterId": "f6a79839-6b06-42c6-9bca-a9867653968a",
"characterName": "青蛙"
}
]
}
]
}
]
},
"log_id": 1827961649807748597
}curl示例
curl --location 'http://10.163.171.23:8080/rpc/2.0/wenxin/v1/image/desc/query?BIZ_VERSION=1&appid=1198' \
--header 'X-dev-origin-user-id: 4316051661' \
--header 'X-dev-user-account-type: passport' \
--header 'Content-Type: application/json' \
--data '{
"jobId": 1828335889433093445
}
'错误码
| 错误码 | 错误信息 | 描述 |
|---|---|---|
| 282000 | internal error | 输入特殊表情字符或服务器内部错误，请调整输入文本再次请求， 如果持续出现此类错误，请在控制台提交工单联系技术支持团队 |
| 216303 | 任务超时，请重新尝试 | 当等待时间超过默认配置时间或者自定义超时时间，查询任务结果时报超时错误，默认超时时间为5分钟。若您按照默认并发2调用遇到了超时报错问题，可以增加多次重试逻辑以重新提交超时任务，或通过自定义超时时间进行灵活调整；若仍对您的业务造成较大影响，请通过客户经理或提交工单联系我们 |
| 282004 | 文本内容拦截 | 请求内容超过800字 |
| 282003 | miss required request parameter | 缺少必要参数，或请求中包含敏感词、非法参数，请检查入参 |
| 17 | online flow control | 日配额流量超限 |
| 18 | Open api qps request limit reached | QPS 超限额 |
| 4 | 请求超限 | 错误信息为中文的“请求超限”指所有用户提交的API请求总数超限制 |
| 18 | QPS 超限 | 错误信息为中文的“QPS 超限”指单个用户使用提交请求接口的 QPS 超限 |
| 15 | 并发超限 | 错误信息为中文的“并发超限”指单个用户使用API的并发超限 |
| 17 | 用量超限 | 错误信息为中文的“用量超限”指单个用户使用API的用量超限 |
| 5 | 任务进行中 | 任务正在处理中，请稍后查询结果 |