AI作画-基础版
更新时间:2024-06-22
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链接或原图给到百度进行提取。
- 水印示例:
错误码
错误码 | 错误信息 | 描述 |
---|---|---|
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作画使用指南。