AI作画-主体一致图像生成与调整

更新时间：2024-10-30

接口描述

AI 作画-主体一致图像生成与调整，可根据用户输入的文本，以及主体形象参考图，生成主体一致的多张图片，自动创作图片。涉及2个接口，分别为：提交请求、查询结果。

提交请求：支持传入文本、分辨率、数量、参考图等参数，创建 AI 作画任务，获得任务ID。
查询结果：用于在任务创建后，查看图片生成状态。待图片生成完毕，通过查询接口即可查看生成图片的地址链接。

主体一致图像生成与调整-提交请求-接口说明

请求示例

HTTP方法: POST

请求URL: https://aip.baidubce.com/rpc/2.0/wenxin/v1/image/paint/gen

URL参数：

参数	值
access_token	通过API Key和Secret Key获取的access_token,参考“Access Token获取”

Header如下：

参数	值
Content-Type	application/json

请求参数

POST 方式调用

注意：要求使用 JSON 格式的结构体来描述一个请求的具体内容。

参数	是否必填	类型	描述
prompt	是	string	画面文本描述长度1-190
refBackground	否	string	背景参考图链接
refScaleBack	否	int	背景参考图强度 1-10
refInfos	否	list	角色参考图信息
+refImage	否	string	角色参考图片链接
+refName	否	string	角色名或者背景；如果是背景，则该值为"背景"，否则为具体角色名
+refPrompt	否	string	角色描述或者背景；如果是背景，则该值为""
+faceControl	否	string	角色人脸增强控制，默认值“0”为关闭状态，如果开启传“1”，不传为关闭状态。当为开启状态时：①可强化人脸五官迁移到图片中的效果；②可通过prompt字段控制人物的布局、服饰；③暂时不支持使用背景参考图，此时refBackground、refScaleBack失效；④该参数只对只有一个主体的图片生效，不支持控制多个主体，故当存在多个主体信息输入时，只能对顺序为第一个的主体生效。
text_content	否	string	1~50个字符，支持英文、数字及常用特殊字符。若不传该参数则默认为Text-to-Image-内容ID-AI，示例：Text-to-Image-131870381_0_finaI.png-Al；若传该参数，则相应水印内容自动添加至Text-to-Image后方，示例：Text-to-Image-ABCD-131870381_0_finaI.png-Al
image_num	是	int	图片张数 1-8
width	是	int	图片宽度，支持：512x512、640x360、360x640、1024x1024、1280x720、720x1280、2048x2048、2560x1440、1440x2560、3840x2160、2160x3840
height	是	int	图片高度，支持：512x512、640x360、360x640、1024x1024、1280x720、720x1280、2048x2048、2560x1440、1440x2560、3840x2160、2160x3840

请求示例

{
    "prompt": "王子和公主在森林里嬉戏",
    "refBackground": "https://qiaozhuo.bj.bcebos.com/u%3D1630778950%2C797742157%26fm%3D253%26fmt%3Dauto%26app%3D120%26f%3DJPEG.webp",
    "text_content":"udheidk",
    "refInfos": [
        {
            "refImage":"https://qiaozhuo.bj.bcebos.com/qJHPf4BzdB9BT7kUGQHZ_1(1).jpg",
            "refName":"王子",
            "refPrompt":"白发王子，穿着华丽的衣服"
        },
        {
            "refImage":"https://qiaozhuo.bj.bcebos.com/7Ngd6sRaEqyRVJAKncRp_1(1).jpg",
            "refName":"公主",
            "refPrompt":"红发公主，穿着华丽的衣服"
        }
    ],
    "image_num":1,
    "width":1280,
    "height":720
}

人脸控制请求示例

{
    "prompt": "男人和狮子站在一起。",
    "refInfos": [
        {
            "refImage":"https://qiaozhuo.bj.bcebos.com/%E7%94%B7%E4%BA%BA.webp",
            "refName":"男人",
            "faceControl":1,
            "refPrompt":"黄种人，亚洲人"
        }
    ],
    "image_num":1,
    "width":1280,
    "height":720
}

返回说明

JSON 格式

注意：若输入为 UTF-8 编码（通过指定 charset 参数），则返回内容为 UTF-8 编码

返回参数

参数	类型	描述
log_id	long	请求唯一标识码
data	object	返回数据
primary_task_id	long	生成图片任务long类型 id，与“task_id”参数输出相同，该 id 可用于查询任务状态
task_id	string	生成图片任务string类型 id，与“primary_task_id”参数输出相同，该 id 可用于查询任务状态
error_msg	string	错误提示信息，失败才返回，成功不返回
error_detail	object[]	提示词和参考图审核不通过原因明细，审核失败才返回，审核成功不返回
├─msg	string	不合规项描述信息
├─words	object[]	送检文本命中词库的关键词
error_code	number	错误提示码，失败才返回，成功不返回

返回示例

{
    "data": {
        "primary_task_id": 1846746884612208867,
        "task_id": "1846746884612208867"
    },
    "log_id": 1846746884612208867
}

主体一致图像生成与调整-查询结果-接口说明

请求示例

HTTP方法: POST

请求URL: https://aip.baidubce.com/rpc/2.0/wenxin/v1/image/paint/query

URL参数：

参数	值
access_token	通过API Key和Secret Key获取的access_token,参考“Access Token获取”

Header如下：

参数	值
Content-Type	application/json

请求格式

POST 方式调用

注意：要求使用 JSON 格式的结构体来描述一个请求的具体内容。

请求参数

参数	是否必选	类型	描述
task_id	是	long或string	任务ID

请求示例

{
    "task_id": "1846746884612208867"
}

返回格式

JSON 格式

返回参数

参数	是否必选	类型	描述
log_id	是	long	请求唯一标识码
data	是	object	返回数据
├─task_id	是	long	任务 Id
├─task_status	是	string	计算总状态。有 INIT（初始化），WAIT（排队中）, RUNNING（生成中）, FAILED（失败）, SUCCESS（成功）四种状态，只有 SUCCESS 为成功状态
├─task_progress_detail	是	number	图片生成总进度，0为未处理完， 1为处理完成
├─task_progress	是	number	图片生成总进度，进度包含2种，0为未处理完，1为处理完成
├─sub_task_result_list	是	object[]	子任务生成结果列表
├─sub_task_status	是	string	单风格图片状态。有 INIT（初始化），WAIT（排队中）, RUNNING（生成中）, FAILED（失败）, SUCCESS（成功）四种状态，只有 SUCCESS 为成功状态
├─sub_task_progress_detail	是	number	单任务图片生成进度，0为未处理完， 1为处理完成
├─sub_task_progress	是	number	单任务图片生成进度，进度包含2种，0为未处理完，1为处理完成
├─sub_task_error_code	是	string	单风格任务错误码。0:正常；501:文本黄反拦截；201:模型生图失败
├─final_image_list	是	object []	单风格任务产出的最终图列表
├─img_url	是	string	图片所在 BOS http 地址，默认 30 天失效
├─height	是	integer	图片像素信息-高度
├─width	是	integer	图片像素信息-宽度
├─img_approve_conclusion	是	string	图片机审结果，"block"：输出图片违规；"review": 输出图片疑似违规；"pass": 输出图片未发现问题；

返回示例

{
    "data": {
        "task_progress_detail": 1,
        "task_progress": 1,
        "task_status": "SUCCESS",
        "sub_task_result_list": [
            {
                "final_image_list": [
                    {
                        "width": 1280,
                        "img_url": "http://bj.bcebos.com/v1/ai-picture-creation/watermark/oWCksQr3KXYXvieRcn3ZMj_0.jpg?authorization=bce-auth-v1%2FALTAKBvI5HDpIAzJaklvFTUfAz%2F2024-08-30T03%3A00%3A45Z%2F86400%2F%2F5154e1609cc25c4b3de13e1daa37d33f539270a01e351e271d42c313cbef6a46",
                        "img_approve_conclusion": "pass",
                        "height": 720
                    }
                ],
                "sub_task_progress_detail": 1,
                "sub_task_progress": 1,
                "sub_task_error_code": 0,
                "sub_task_status": "SUCCESS"
            }
        ]
    },
    "log_id": 1829355387615277345
}

错误码

错误码	错误信息	描述
282000	internal error	输入特殊表情字符或服务器内部错误，请调整输入文本再次请求，如果持续出现此类错误，请在控制台提交工单联系技术支持团队
216303	任务超时，请重新尝试	当等待时间超过默认配置时间或者自定义超时时间，查询任务结果时报超时错误，默认超时时间为5分钟。若您按照默认并发2调用遇到了超时报错问题，可以增加多次重试逻辑以重新提交超时任务，或通过自定义超时时间进行灵活调整；若仍对您的业务造成较大影响，请通过客户经理或提交工单联系我们
282004	文本敏感信息拦截/图片敏感信息拦截	请求中包含敏感词、非法参数、字数超限，或上传违规参考图，请检查后重新尝试
282003	miss required request parameter	缺少必要参数
17	online flow control	日配额流量超限
18	Open api qps request limit reached	QPS 超限额
216630	param change_degree not exist	缺少 change_degree 参数，当image、url或 pdf_file 字段存在时，change_degree 为必填参数
501	sub_task_error_code 参数返回	文本黄反拦截
503	sub_task_error_code 参数返回	IP版权拦截
201	sub_task_error_code 参数返回	模型生图失败
100	Invalid parameter	包含了无效或错误参数，请检查代码
216100	invalid parameter 无效参数	参数不满足格式要求
216201	image format error	参考图不满足格式要求
216205	input oversize	参考图尺寸不满足要求
4	请求超限	错误信息为中文的“请求超限”指所有用户提交的 AI 作画总数超限制
13	QPS 超限	错误信息为中文的“QPS 超限”指单个用户使用提交请求接口的 QPS 超限
15	并发超限	错误信息为中文的“并发超限”指单个用户使用 AI 作画的并发超限
17	用量超限	错误信息为中文的“用量超限”指单个用户使用 AI 作画的用量超限

AI作画-画面描述生成

常见问题及排查

百度智能云

语言与知识

语言与知识

AI作画-主体一致图像生成与调整

接口描述

主体一致图像生成与调整-提交请求-接口说明

主体一致图像生成与调整-查询结果-接口说明

错误码