AI作画-基础版
更新时间：2024-11-13
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~50个字符，支持英文、数字及常用特殊字符。若不传该参数则默认为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": 1856547287829480371,
"primaryTaskId": "1856547287829480371"
},
"log_id": 1856547287829480371
}查询结果
接口描述
查询结果接口，根据图片生成任务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
请求参数
| 参数 | 类型 | 描述 |
|---|---|---|
| log_id | long | 请求唯一标识码 |
| taskId | long | 从提交请求的提交接口的返回值中获取 |
| error_msg | string | 错误提示信息，失败才返回，成功不返回 |
| error_detail | object[] | 提示词审核不通过原因明细，审核失败才返回，审核成功不返回 |
| ├─msg | string | 不合规项描述信息 |
| ├─words | object[] | 送检文本命中词库的关键词 |
| error_code | number | 错误提示码，失败才返回，成功不返回 |
Body示例
{
"taskId":1856547287829480371
}返回说明
返回参数
| 参数 | 类型 | 描述 |
|---|---|---|
| data | object | task_id对应请求的任务状态和生成结果 |
| +style | string | 请求内容中的图片风格 |
| +taskId | long | 对应任务的id |
| +imgUrls | array | 生成结果数组（目前默认生成1张图） |
| ++image | string | 生成结果地址（有效期30天），在使用图片链接时需附带上authorization的鉴权信息， ，例如“http://bj.bcebos.com/v1/ai-picture-creation/watermark/294126732_0_final.png?authorization=bce-auth-v1/ALTAKBvI5HDpIAzJaklvFTUfAz/2024-11-13T03:59:15Z/2592000//64fd651ea78e8bb0efbdf883f3c9213c4ce5f6573542b0d87ca8e07c02d3eb6c ”，请使用完整的图片的链接 |
| +text | string | 请求内容中的文本 |
| +status | int | 0或1。"1"表示已生成完成，"0"表示任务排队中或正在处理。 |
| +createTime | string | 任务创建时间 |
| +img | string | 生成结果地址 |
| +waiting | string | 预计等待时间（仅供参考） |
| log_id | long | 请求唯一标识码 |
返回示例
{
"data": {
"style": "油画",
"taskId": 1856547287829480371,
"imgUrls": [
{
"image": "http://bj.bcebos.com/v1/ai-picture-creation/watermark/294126732_0_final.png?authorization=bce-auth-v1%2FALTAKBvI5HDpIAzJaklvFTUfAz%2F2024-11-13T03%3A59%3A15Z%2F2592000%2F%2F64fd651ea78e8bb0efbdf883f3c9213c4ce5f6573542b0d87ca8e07c02d3eb6c",
"img_approve_conclusion": "pass"
}
],
"text": "睡莲",
"status": 1,
"createTime": "2024-11-13 11:59:01",
"img": "http://bj.bcebos.com/v1/ai-picture-creation/watermark/294126732_0_final.png?authorization=bce-auth-v1%2FALTAKBvI5HDpIAzJaklvFTUfAz%2F2024-11-13T03%3A59%3A15Z%2F2592000%2F%2F64fd651ea78e8bb0efbdf883f3c9213c4ce5f6573542b0d87ca8e07c02d3eb6c",
"waiting": "0s"
},
"log_id": 1856547481071524547
}暗水印
- 水印包含内容：服务提供者名称（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作画使用指南。