526互联

文心一格接入

发布时间 2023-12-20 09:29:26作者: 梅丹隆

〇、获取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获取
”

Header

参数 值
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