资讯 文档
技术能力
语音技术
文字识别
人脸与人体
图像技术
语言与知识
视频技术

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

接口描述

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 背景参考图链接
refBackgroundBase64 string 背景参考图,需 base64 编码,大小不超过 10M,最短边至少 15px,最长边最大 8192px,支持jpg/jpeg/png/bmp 格式。优先级:refBackgroundBase64 > refBackground,当refBackgroundBase64 字段存在时,refBackground 字段失效
refScaleBack int 背景参考图强度 1-10
refInfos list 角色参考图信息
+refImage string 角色参考图片链接
+refImageBase64 string 角色参考图,需 base64 编码,大小不超过 10M,最短边至少 15px,最长边最大 8192px,支持jpg/jpeg/png/bmp 格式。优先级:refImageBase64 > refImage,当refImageBase64 字段存在时,refImage 字段失效
+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作画-画面描述生成
下一篇
常见问题及排查