AI作画-高级版

更新时间：2023-09-26

接口描述

AI 作画，基于文心大模型，根据用户输入的文本，自动创作图片。AI 作画-高级版涉及2个接口，分别为：提交请求、查询结果。

提交请求：支持传入文本、分辨率、数量、参考图等参数，创建 AI 作画任务，获得任务ID。
查询结果：用于在任务创建后，查看图片生成状态。待图片生成完毕，通过查询接口即可查看生成图片的地址链接。
并发概念：并发数指 AI 作画高级版服务同时能处理的请求数量。上一个任务执行完，拿到结果后，并发才结束。
若您对于 prompt 输入有疑问，请参考 “AI作画-高级版使用指南” 。
并发数：付费使用后AI作画-高级版图片生成处理过程并发提升为2

提交请求-接口说明

在线调试

您可以在示例代码中心中调试该接口，可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。

请求示例

HTTP方法: POST

请求URL: https://aip.baidubce.com/rpc/2.0/ernievilg/v1/txt2imgv2

URL参数：

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

Header如下：

参数	值
Content-Type	application/json

请求参数

POST 方式调用

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

参数	是否必选	类型	描述
prompt	是	string	生图的文本描述。仅支持中文、日常标点符号。不支持英文，特殊符号，限制 200 字
version	否	string	模型版本，支持 v1、v2，默认为v2，v2 为最新模型，比 v1 在准确度、精细度上有比较明显的提升，且 v2 支持更多尺寸
width	是	integer	图片宽度，v1 版本支持：1024x1024、1280x720、720x1280、2048x2048、2560x1440、1440x2560；v2 版本支持：512x512、640x360、360x640、1024x1024、1280x720、720x1280、2048x2048、2560x1440、1440x2560
height	是	integer	图片高度，v1 版本支持：1024x1024、1280x720、720x1280、2048x2048、2560x1440、1440x2560；v2 版本支持：512x512、640x360、360x640、1024x1024、1280x720、720x1280、2048x2048、2560x1440、1440x2560
image_num	否	number	生成图片数量，默认一张，支持生成 1-8 张
image	否，和url/pdf_file 三选一	string	参考图，需 base64 编码，大小不超过 10M，最短边至少 15px，最长边最大 8192px，支持jpg/jpeg/png/bmp 格式。优先级：image > url > pdf_file，当image 字段存在时，url、pdf_file 字段失效
url	否，和image/pdf_file 三选一	string	参考图完整 url，url 长度不超过 1024 字节，url 对应的图片需 base64 编码，大小不超过 10M，最短边至少 15px，最长边最大8192px，支持 jpg/jpeg/png/bmp 格式。优先级：image > url > pdf_file，当image 字段存在时，url 字段失效请注意关闭 URL 防盗链
pdf_file	否，和image/url 三选一	string	参考图 PDF 文件，base64 编码，大小不超过10M，最短边至少 15px，最长边最大 8192px 。优先级：image > url > pdf_file，当image 字段存在时，url、pdf_file 字段失效
pdf_file_num	否	string	需要识别的 PDF 文件的对应页码，当pdf_file 参数有效时，识别传入页码的对应页面内容，若不传入，则默认识别第 1 页
change_degree	否，当 image、url或 pdf_file 字段存在时，为必需项	integer	参考图影响因子，支持 1-10 内；数值越大参考图影响越大

请求示例

{
   "prompt": "睡莲",
   "version": "v1",
   "width": 1024,
   "height": 1024,
   "image_num": 1,
   "image": ""（base64 编码）,
   "change_degree":1
}

返回说明

JSON 格式

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

返回参数

参数	类型	描述
log_id	uint64	请求唯一标识码
data	object	返回数据
primary_task_id	long	生成图片任务long类型 id，与“task_id”参数输出相同，该 id 可用于查询任务状态
task_id	string	生成图片任务string类型 id，与“primary_task_id”参数输出相同，该 id 可用于查询任务状态

返回示例

{
    "data": {
        "primary_task_id": 1659384536691865192,
        "task_id": "1659384536691865192"
    },
    "log_id": 1583376431827547238
}

查询结果-接口说明

在线调试

您可以在示例代码中心中调试该接口，可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。

请求示例

HTTP方法: POST

请求URL: https://aip.baidubce.com/rpc/2.0/ernievilg/v1/getImgv2

URL参数：

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

Header如下：

参数	值
Content-Type	application/json

并发数：付费后默认并发数为 2

请求格式

POST 方式调用

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

请求参数

参数	是否必选	类型	描述
task_id	是	long或string	从提交请求的提交接口的返回值中获取，可使用task_id 查询总任务

请求示例1

{
 "task_id":  1659384536691865192
}

请求示例2

{
 "task_id":  “1659384536691865192”
}

返回格式

JSON 格式

返回参数

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

计费规则：返回图片链接计费，因审核拦截等情况导致未返回图片链接不进行计费

返回示例

{
   "log_id": 1583376431827547238,
   "data": {
     "task_id": 1659384536691865192,
     "task_status": "SUCCESS",
     "task_progress": 1
     "sub_task_result_list": [
        {
          "sub_task_status": "SUCCESS",
          "sub_task_progress": 1,

          "sub_task_error_code": 0,
          "final_image_list": [
             {  
             "img_approve_conclusion": "pass",
               "img_url": "http://aigc-t2p-dev.bj.bcebos.com/artist-
long/50601_0_final.png?authorization=bce-auth-
v1%2F166d4fe6e8164b10bc178a36df207978%2F2023-04-
03T03%3A36%3A54Z%2F1800%2Fhost%2F116f64fdd5c17dff734783cd4ee144b036fd7ea7fdaa23
7928153c2039d4ceac",
                "width": 512,
                "height": 512
           }
        ]
      }
    ]
  }
}

错误码

错误码	错误信息	描述
282000	internal error	服务器内部错误，请再次请求，如果持续出现此类错误，请在控制台提交工单联系技术支持团队
282004	文本黄反拦截/图片黄反拦截	请求中包含敏感词、非法参数、字数超限，或上传违规参考图，请检查后重新尝试
282003	miss required request parameter	缺少必要参数
17	online flow control	日配额流量超限
18	Open api qps request limit reached	QPS 超限额
216630	recognize error	服务器内部错误，请再次请求，如果持续出现此类错误，请通过工单联系技术支持
501	sub_task_error_code 参数返回	文本黄反拦截
201	sub_task_error_code 参数返回	模型生图失败
216100	invalid parameter 无效参数	参数不满足格式要求
216201	image format error	参考图不满足格式要求
4	请求超限	错误信息为中文的“请求超限”指所有用户提交的 AI 作画总数超限制
13	QPS 超限	错误信息为中文的“QPS 超限”指单个用户使用提交请求接口的 QPS 超限
15	并发超限	错误信息为中文的“并发超限”指单个用户使用 AI 作画的并发超限
17	用量超限	错误信息为中文的“用量超限”指单个用户使用 AI 作画的用量超限

购买指南

AI作画-基础版

百度智能云

语言与知识

语言与知识

AI作画-高级版

提交请求-接口说明

在线调试

查询结果-接口说明

在线调试

错误码