Task Submission

Update:

API Overview

POSThttps://isafe.ilivedata.com/api/v2/image/batchCheck/async

Asynchronous batch image moderation API. After images are submitted, they will be moderated and the results will be returned via callback. Callback can be configured in Console - Service Configuration or passed via request parameters.

Image requirements
Supported types: URL, BASE64
Supported formats: jpg, png, bmp, gif, webp, tiff, heic, avif
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.

Request Parameters

Request Headers

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 — UTC time when the request is sent, in W3C format.
Example: 2026-09-30T02:30:00Z. Use the current time for actual requests.
Authorization — Signature value

Request Body

Parameter Type Required Description
images Array Required Images to moderate, up to 20 elements. See structure below
requestId String Optional Request ID used to identify the parent request ID for this batch request; a random value is generated by the server if not provided
callbackUrl String Optional Callback URL (http); also provide callbackSecretKey when configuring the callback through this request.
callbackSecretKey String Optional Callback signature key, must match the key used for callback verification
callbackWaitForAll Boolean Optional Whether to wait until all moderation is done before callback. When true, the callback follows the batch callback protocol; otherwise it follows the single callback protocol
images[].type Number Required Image content type: 1: image URL; 2: image BASE64 value
images[].image String Required Image content. When type=1 it is the image URL; when type=2 it is the image BASE64 value
images[].strategyId String Optional Strategy ID; uses default strategy DEFAULT when not provided
images[].checkTags List<Number> Optional Restrict detection categories, supports first-level categories enabled in the strategy
images[].referImage String Optional Reference image for face comparison, type must match image. Supported formats: jpg, png; size < 10M
images[].userId String Optional Unique end user ID, no more than 32 characters
images[].extra Object Optional 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

Request Example

{
  "requestId": "batch_f1a2556604274a35831c0f07d4ecc8c2",
  "images": [
    {
      "type": 1,
      "image": "http://abc.com/a.jpg",
      "userId": "123"
    },
    {
      "type": 1,
      "image": "http://abc.com/b.jpg",
      "userId": "123"
    }
  ],
  "callbackUrl": "http://your.callback.url/batchCallback",
  "callbackSecretKey": "your-callback-secret",
  "callbackWaitForAll": true
}

Request Signature

See Request Signature in Help Center. Use these values for this endpoint:

Signing Parameter Value
HTTPMethod POST
HostHeaderInLowercase isafe.ilivedata.com
HTTPRequestURI /api/v2/image/batchCheck/async

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 Array Submission result array; each element corresponds to one image in the request images

result element fields

Field Type Description
errorCode Number Error code: 0 means success
errorMessage String Error message
taskId String Task ID, used to associate with the callback result

Response Example

{
  "errorCode": 0,
  "requestId": "batch_f1a2556604274a35831c0f07d4ecc8c2",
  "result": [
    {
      "errorCode": 0,
      "taskId": "ap_99b2bf004d4a4591bfedbba9574e74d4_1702882338368"
    },
    {
      "errorCode": 0,
      "taskId": "ap_d8d58cc2ecf14edaafd18692997a1f67_1702882338368"
    }
  ]
}

Error Codes

See Common Error Codes in Help Center