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

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 字
width integer 图片宽度,支持:512x512、640x360、360x640、1024x1024、1280x720、720x1280、2048x2048、2560x1440、1440x2560
height integer 图片高度,支持: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 内;数值越大参考图影响越大
version string 不传该参数为默认版本(生图质量更佳),如果您希望生图时长更短,可传入"fast"参数

请求示例

{
   "prompt": "睡莲",
   "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":  1770382244428192494
}

请求示例2

{
 "task_id":  “1770382244428192494”
}

返回格式

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 地址,默认 24 小时失效
├─height integer 图片像素信息-高度
├─width integer 图片像素信息-宽度
├─img_approve_conclusion string 图片机审结果,"block":输出图片违规;"review": 输出图片疑似违规;"pass": 输出图片未发现问题;

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

返回示例

{
    "data": {
        "task_status": "SUCCESS",
        "task_progress": 1,
        "sub_task_result_list": [
            {
                "final_image_list": [
                    {
                        "width": 1024,
                        "img_url": "http://bj.bcebos.com/v1/ai-picture-creation/watermark/159070934_0_final.png?authorization=bce-auth-v1%2FALTAKBvI5HDpIAzJaklvFTUfAz%2F2024-03-20T09%3A30%3A19Z%2F86400%2F%2F6df1500ba34693308ac83e21ef1482014dbba49b4d07d3953a149e78c3da8d85",
                        "img_approve_conclusion": "pass",
                        "height": 1024
                    }
                ],
                "sub_task_error_code": 0,
                "sub_task_status": "SUCCESS",
                "sub_task_progress": 1
            }
        ],
        "task_id": 1770382244428192494
    },
    "log_id": 1770399445832373850
}

错误码

错误码 错误信息 描述
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作画-基础版