任务提交

该文档为 V1 版本接口。V2 版本接口已上线，请求/响应结构更清晰，推荐使用：任务提交（V2）。

请求规范

• 请求 URL:

https://isafe.ilivedata.com/api/v1/image/batchCheck/async

• 接口描述:

图片异步检测接口，图片信息提交后，会对图片进行检测，检测结果会通过回调方式返回，回调配置可在控制台服务配置中配置或者通过参数传入。

• 图片要求:

  • 图片支持类型：URL, BASE64

  • 图片支持格式：jpg, png, bmp, gif, webp, tiff, heic

  • 图片大小：单张<10M

  • gif图、长图说明：自动将gif图、长图（长宽比大于5的图片）截帧过检，最多5张，gif图长图均按照实际截图张数进行计费

• HTTP 请求Header:

• 请求方法:POST

• 请求体JSON对象：

  • 公共参数

• 新增参数

  参数	必需	类型	描述
  callbackRegion	可选	String	回调区域：默认cn，可选cn，us，ap。不给或不在取值范围内默认使用cn区域发起回调
  callbackUrl	可选	String	回调url：http协议
  callbackSecretKey	可选	String	回调密钥，可自行定义，需要在回调验签方式使用密钥一致，否则无法验证回调数据是否被篡改
  callbackWaitForAll	可选	boolean	是否等待所有审核处理完成后再回调；为true时回调将会按照batch-callback协议文档，否则按照callback协议文档

• 请求体示例:

    {
     "images": [
       {
       "id": "abcd",
       "type": 1,
       "userId": "123",
       "image": "http://abc.com/a.jpg",
       },
       {
       "type": 1,
       "userId": "123",
       "image": " http://abc.com/b.jpg",
       }
      ]
    }
  

• 请求签名:

该接口需要在请求 Header 中传入 Authorization 签名。签名计算规则请参考帮助中心的请求签名。

HTTP响应

Content-Type: application/json;charset=UTF-8

结果为JSON格式，请参考以下示例。

• 返回json字段说明：

返回json为单张图片异步请求结果json对象组成的json数组。

• 单张图片异步返回json字段说明：

• 返回结果示例:

    [
    { 
    "id":"abcd",
    "errorCode":0,
    "taskId":"Telnet-test_99b2bf004d4a4591bfedbba9574e74d4_1702882338368"},
    {"errorCode":0,
    "taskId":"Telnet-test_d8d58cc2ecf14edaafd18692997a1f67_1702882338368"}
    ]
  

错误码

详见帮助中心的常见异常码