Batch Image Synchronous Moderation

Update:

Parameter Specification

  • Request URL:

https://isafe.ilivedata.com/api/v2/image/batchCheck

  • Image requirements:

    • Supported types: URL, BASE64
    • Supported formats: jpg, png, bmp, gif, webp, tiff, heic
    • Supported image size: < 10M
    • Description of gif/long image: Automatically cut gif/long image (ratio of length and width greater than 5) into frames and check, up to 5 images. Gif/long images are billed according to the actual number of screenshots.

  • HTTP request Header:

Header Value Description
Content-Type application/json;charset=UTF-8 Request body type
Accept application/json;charset=UTF-8 Return type accepted
X-AppId The unique identifier of the project, from Console - Service Configuration
X-TimeStamp The UTC timestamp of the request, formatted per W3C, e.g. 2010-01-31T23:59:59Z. (http://www.w3.org/TR/xmlschema-2/#dateTime)
Authorization Signature value

  • Request method: POST

  • Request body JSON object:

Parameter Required Type Description
images Required json array Images to moderate, up to 20 elements. See structure below
requestId Optional String Request ID used to identify the parent request ID for this batch request; a random value is generated by the server if not provided
  • images element structure:
Parameter Required Type Description
type Required Number Image content type: 1: image URL; 2: image BASE64 value
image Required String Image content. When type=1 it is the image URL; when type=2 it is the image BASE64 value
strategyId Optional String Strategy ID; uses default strategy DEFAULT when not provided
checkTags Optional List<Number> Restrict detection categories, supports first-level categories enabled in the strategy
referImage Optional String Reference image for face comparison, type must match image. Supported formats: jpg, png; size < 10M
userId Optional String Unique end user ID, no more than 32 characters
extra Optional json Extension fields transparently passed through. No more than 20 key/value pairs; a single key must not be nested more than 3 levels deep. If exceeded, the audit log will not record the extra value for this task, but extra transparent passthrough in the response is unaffected
  • Example of request body:
{
  "requestId": "batch_f1a2556604274a35831c0f07d4ecc8c2",
  "images": [
    {
      "type": 1,
      "image": "http://abc.com/a.jpg",
      "userId": "testUser1"
    },
    {
      "type": 2,
      "image": "T2dnUwACAAAAAAAAAAAd8pVTAAAAAGsIvpMBE...",
      "userId": "testUser2"
    }
  ]
}
  • Request signature:

This API requires the Authorization signature in the request Header. For the signature calculation rule, see Request Signature. Use /api/v2/image/batchCheck as HTTPRequestURI.

HTTP Response

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

The response is a JSON object with the following structure:

Parameter Type Description
errorCode Number Error code: 0 if any item has errorCode 0; otherwise the first item’s errorCode
requestId String Request ID that identifies the parent request ID for this batch request
result json array Moderation result array; each element corresponds to one image in the request images
  • result element structure:

Same as the single image response, plus the following fields:

Parameter Type Description
index Number Index of the corresponding image in the request images

For other fields (errorCode, errorMessage, result, taskId, mediaType, snapshotUrl, imageSpams, ocr, personInfo, labels, extra), see Single Image Synchronous Moderation (V2) - HTTP Response.

  • Example of response:
{
  "errorCode": 0,
  "requestId": "batch_f1a2556604274a35831c0f07d4ecc8c2",
  "result": [
    {
      "index": 0,
      "errorCode": 0,
      "result": 2,
      "taskId": "ap_634e686ef7e54447af7463f4dd060d6d_1783514588456",
      "imageSpams": {
        "tags": [
          {
            "tag": 130,
            "level": 2,
            "confidence": 100,
            "nameZh": "色情",
            "nameEn": "porn",
            "subTags": [
              {
                "subTag": 130001,
                "level": 2,
                "confidence": 100,
                "nameZh": "女胸裸露",
                "nameEn": "bare breasts"
              }
            ]
          }
        ]
      },
      "personInfo": {
        "human": { "number": 1 },
        "face": { "number": 4 }
      },
      "extra": {}
    },
    {
      "index": 1,
      "errorCode": 0,
      "result": 0,
      "taskId": "ap_a868a01f9d8a45648df79a03cfa25bcb_1783514588456",
      "imageSpams": { "tags": [] },
      "extra": {}
    }
  ]
}

Error Codes

See Common Exception Codes in Help Center