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

AI作画-基础版

AI作画-基础版,基于文心大模型,根据用户输入的文本,自动创作图片,每次可自定义生成1张至6张图片。在使用AI作画接口服务之前,请您仔细阅读相关协议的全部内容。

AI作画-基础版涉及2个接口,分别为:提交请求、查询结果。

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

提交请求

接口描述

提交请求接口,根据用户输入的文本,得到图片生成任务ID。

请求说明

请求示例

HTTP方法: POST

请求URL: https://aip.baidubce.com/rpc/2.0/wenxin/v1/basic/textToImage

URL参数:

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

Header如下:

参数
Content-Type application/json

并发数:付费使用后默认并发数为 2

请求参数

参数 是否必选 类型 描述
text string 输入内容,长度不超过190个字(操作指南详见文档
resolution string 图片分辨率,可支持512*512、640*360、360*640、1024*1024、720*1280、1280*720
style string 目前支持风格有:二次元、写实风格、古风、赛博朋克、水彩画、油画、卡通画,更多风格可自行探索
num int 图片生成数量,支持1-6张
text_content string 1~10个字符,支持英文、数字及常用特殊字符。若不传该参数则默认为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

Body示例

{
    "text": "睡莲",
    "style": "油画",
    "resolution": "1024*1024",
    "num": 1
}

返回说明

返回参数

参数 类型 描述
log_id uint64 请求唯一标识码
data object 结果对象,返回 task id。任务完成后,作为获取图片的依据
taskId long 图片生成任务id,作为查询接口的入参
primaryTaskId string 生成图片任务string类型 id,与“taskId”参数输出相同,该 id 可用于查询任务状态

返回示例

{
    "data": {
        "taskId": 1798207147175732651,
        "primaryTaskId": "1798207147175732651"
    },
    "log_id": 1798207147175732651
}

查询结果

接口描述

查询结果接口,根据图片生成任务ID,查询生成状态。

请求说明

请求示例

HTTP方法: POST

请求URL: https://aip.baidubce.com/rpc/2.0/wenxin/v1/basic/getImg

URL参数:

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

Header如下:

参数
Content-Type application/json

并发数:付费使用后默认并发数为 2

请求参数

参数 是否必选 类型 描述
taskId long 从提交请求的提交接口的返回值中获取

Body示例

{
    "taskId":1798207147175732651
}

返回说明

返回参数

参数 类型 描述
data object task_id对应请求的任务状态和生成结果
+style string 请求内容中的图片风格
+taskId long 对应任务的id
+imgUrls array 生成结果数组(目前默认生成1张图)
++image string 生成结果地址(有效期24小时)
+text string 请求内容中的文本
+status int 0或1。"1"表示已生成完成,"0"表示任务排队中或正在处理。
+createTime string 任务创建时间
+img string 生成结果地址
+waiting string 预计等待时间(仅供参考)
log_id uint64 请求唯一标识码

返回示例

{
    "data": {
        "style": "油画",
        "taskId": 1798207147175732651,
        "imgUrls": [
            {
                "image": "http://bj.bcebos.com/v1/ai-picture-creation/watermark/60d1e8cc4f6406c4dffdfa2976150872ex.jpg?authorization=bce-auth-v1%2FALTAKBvI5HDpIAzJaklvFTUfAz%2F2024-03-20T11%3A10%3A07Z%2F86400%2F%2F17ec73c2d89b68746f656a7f74beba2cab7de026ba30ab0ab7ca4fe980bf19ad",
                "img_approve_conclusion": "paas"
            }
        ],
        "text": "睡莲",
        "status": 1,
        "createTime": "2024-03-20 19:09:49",
        "img": "http://bj.bcebos.com/v1/ai-picture-creation/watermark/60d1e8cc4f6406c4dffdfa2976150872ex.jpg?authorization=bce-auth-v1%2FALTAKBvI5HDpIAzJaklvFTUfAz%2F2024-03-20T11%3A10%3A07Z%2F86400%2F%2F17ec73c2d89b68746f656a7f74beba2cab7de026ba30ab0ab7ca4fe980bf19ad",
        "waiting": "0"
    },
    "log_id": 1798207147175732651
}

暗水印

  • 水印包含内容:服务提供者名称(Text-to-Image)、内容ID(生成图片的唯一编号)、生成方式(AI)
  • 水印面积:覆盖整张图,水印嵌入在频域。
  • 水印提取:水印提取:当前提取水印需要百度侧使用技术手段提取,暂时没有对外开放。具体提取水印需要您把生成图片的bos链接或原图给到百度进行提取。
  • 水印示例: image.png

错误码

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

AI作画-基础版使用指南,请点击AI作画使用指南

上一篇
AI作画-高级版
下一篇
AI作画-极速版