百度智能云语言处理技术-智能创作平台（API）AI作画高级版

语言处理技术 > 百度智能云语言处理技术-智能创作平台（API）AI作画高级版

产品推荐：

1、安全稳定的云服务器租用，2核/2G/5M仅37元，点击抢购>>>；

2、高防物理服务器20核/16G/50M/200G防御仅350元，点击抢购>>>

3、百度智能建站（五合一网站）仅880元/年，点击抢购>>> 模板建站（PC+手机站）仅480元/年，点击抢购>>>

点击这里申请百度智能云特邀VIP帐号，立即体验语言处理技术>>>

百度智能云语言处理技术-智能创作平台（API）AI作画高级版

接口描述

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
           }
        ]
      }
    ]
  }
}

错误码

错误码	错误信息	描述
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 无效参数	参数不满足格式要求
4	请求超限	错误信息为中文的“请求超限”指所有用户提交的 AI 作画总数超限制
13	QPS 超限	错误信息为中文的“QPS 超限”指单个用户使用提交请求接口的 QPS 超限
15	并发超限	错误信息为中文的“并发超限”指单个用户使用 AI 作画的并发超限
17	用量超限	错误信息为中文的“用量超限”指单个用户使用 AI 作画的用量超限

天翼云文档

百度智能云文档

腾讯云文档

阿里云文档

华为云文档

帐号服务

云计算

云安全

企业服务

备案服务

提交请求-接口说明

查询结果-接口说明

错误码

TOP云产品

解决方案

帮助与支持

其他链接

快速通道

关于 TOP云