标签：task sub 接入 image url 文心 参数 id
〇、获取Access Token
获取AccessToken
一、文生图
AI作画-高级版 - 语言与知识 | 百度智能云文档
请求示例
HTTP方法:
POST
请求URL:
https://aip.baidubce.com/rpc/2.0/ernievilg/v1/txt2imgv2
URL参数：
| 参数 |
值 |
| access_token |
通过API Key和Secret Key获取的access_token,参考“Access Token获取” |
| 参数 |
值 |
| Content-Type |
application/json |
并发数：付费使用后默认并发数为 2
请求参数
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
}
二、查询图片进度/结果
AI作画-高级版 - 语言与知识 | 百度智能云文档
请求示例
HTTP方法
POST
请求URL
https://aip.baidubce.com/rpc/2.0/ernievilg/v1/getImgv2
URL参数：
| 参数 |
值 |
| access_token |
通过API Key和Secret Key获取的access_token,参考“Access Token获取
” |
| 参数 |
值 |
| Content-Type |
application/json |
并发数：付费后默认并发数为 2
请求格式
POST 方式调用
注意：要求使用 JSON 格式的结构体来描述一个请求的具体内容。
请求参数
| 参数 |
是否必选 |
类型 |
描述 |
| task_id |
是 |
long或string |
从提交请求的提交接口的返回值中获取，可使用task_id 查询总任务 |
{
"task_id": 1659384536691865192
}
{
"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": 输出图片未发现问题； |
{
"sub_task_result_list": [
{
"final_image_list": [
{
"height": 1024,
"img_approve_conclusion": "pass",
"img_url": "http://aigc-t2p.bj.bcebos.com/artist-long/30169514_0_final.png?authorization=bce-auth-v1%2F174bf5e9a7a84f55a8e85b1cc5d62b1d%2F2023-07-06T02%3A46%3A53Z%2F1800%2Fhost%2Fb541efeed7bac9a87cb3fd0761cfac6e9ea7edd1fbe46b8e773e09126abd0271",
"width": 1024
}
],
"sub_task_error_code": 0,
"sub_task_progress": 1,
"sub_task_status": "SUCCESS"
},
{
"final_image_list": [
{
"height": 1024,
"img_approve_conclusion": "pass",
"img_url": "http://aigc-t2p.bj.bcebos.com/artist-long/30169515_0_final.png?authorization=bce-auth-v1%2F174bf5e9a7a84f55a8e85b1cc5d62b1d%2F2023-07-06T02%3A46%3A53Z%2F1800%2Fhost%2F764f571b4ba7d9d7567e68c109c2b38c3410c4a2a24db76c3afbaf1c1f306f06",
"width": 1024
}
],
"sub_task_error_code": 0,
"sub_task_progress": 1,
"sub_task_status": "SUCCESS"
},
{
"final_image_list": [
{
"height": 1024,
"img_approve_conclusion": "pass",
"img_url": "http://aigc-t2p.bj.bcebos.com/artist-long/30169516_0_final.png?authorization=bce-auth-v1%2F174bf5e9a7a84f55a8e85b1cc5d62b1d%2F2023-07-06T02%3A46%3A53Z%2F1800%2Fhost%2Fe04f12c45f01fc4199c9975e208f94859d80e68f393821d94eb561997db100a0",
"width": 1024
}
],
"sub_task_error_code": 0,
"sub_task_progress": 1,
"sub_task_status": "SUCCESS"
},
{
"final_image_list": [
{
"height": 1024,
"img_approve_conclusion": "pass",
"img_url": "http://aigc-t2p.bj.bcebos.com/artist-long/30169517_0_final.png?authorization=bce-auth-v1%2F174bf5e9a7a84f55a8e85b1cc5d62b1d%2F2023-07-06T02%3A46%3A53Z%2F1800%2Fhost%2F7517b6724271b2489e0131f6247a6d7466122256d7d553defe293b1fd41a42bc",
"width": 1024
}
],
"sub_task_error_code": 0,
"sub_task_progress": 1,
"sub_task_status": "SUCCESS"
}
],
"task_id": 1676784719699311143,
"task_progress": 1,
"task_status": "SUCCESS"
}
{
"sub_task_result_list": [
{
"sub_task_error_code": 501,
"sub_task_progress": 0,
"sub_task_status": "FAILED"
},
{
"sub_task_error_code": 501,
"sub_task_progress": 0,
"sub_task_status": "FAILED"
},
{
"sub_task_error_code": 501,
"sub_task_progress": 0,
"sub_task_status": "FAILED"
},
{
"sub_task_error_code": 501,
"sub_task_progress": 0,
"sub_task_status": "FAILED"
}
],
"task_id": 1676785356577640297,
"task_progress": 1,
"task_status": "FAILED"
}
三、错误码
| 错误码 |
错误信息 |
描述 |
| 282004 |
invalid parameter(s) |
请求中包含非法参数或字数超限，请检查后重新尝试 |
| 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 作画的用量超限 |
四、参考代码
all-in-one/springboot/aigc/src/main/java/com/mdl/springboot/aigc/service/wenxin/impl/WenxinyigeServiceImpl.java at master · Meidanlong/all-in-one
标签：task,
sub,
接入,
image,
url,
文心,
参数,
id
From： https://www.cnblogs.com/meidanlong/p/17986620