Task Submission
Update:
API Overview
POSThttps://isafe.ilivedata.com/api/v2/image/check/async
Asynchronous image moderation API. After an image is submitted, it will be moderated and the result 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-Typeapplication/json;charset=UTF-8
Request body type
Acceptapplication/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
typeNumber
Required
Image content type: 1: image URL; 2: image BASE64 value
imageString
Required
Image content. When type=1 it is the image URL; when type=2 it is the image BASE64 value
strategyIdString
Optional
Strategy ID; uses default strategy DEFAULT when not provided
checkTagsList<Number>
Optional
Restrict detection categories, supports first-level categories enabled in the strategy
referImageString
Optional
Reference image for face comparison, type must match image. Supported formats: jpg, png; size < 10M
userIdString
Optional
Unique end user ID, no more than 32 characters
extraObject
Optional
Extension fields transparently passed through, multiple key/value pairs. 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
callbackUrlString
Optional
Callback URL (http); also provide callbackSecretKey when configuring the callback through this request.
callbackSecretKeyString
Optional
Callback signature key, must match the key used for callback verification
Request Example
{
"type": 1,
"image": "http://abc.com/a.jpg",
"userId": "123",
"callbackUrl": "http://your.callback.url/callback",
"callbackSecretKey": "your-callback-secret"
}
Request Signature
See Request Signature in Help Center. Use these values for this endpoint:
Signing Parameter
Value
HTTPMethodPOST
HostHeaderInLowercaseisafe.ilivedata.com
HTTPRequestURI/api/v2/image/check/async
HTTP Response
Content-Type: application/json;charset=UTF-8
The result is in JSON format.
Response Fields
Field
Type
Description
errorCodeNumber
Error code: 0 means success
errorMessageString
Error message
taskIdString
Task ID, used to query the result or associate with the callback
Response Example
{
"errorCode": 0,
"taskId": "ap_99b2bf004d4a4591bfedbba9574e74d4_1702882338368"
}
Error Codes
See Common Error Codes in Help Center
API Overview
https://isafe.ilivedata.com/api/v2/image/check/asyncAsynchronous image moderation API. After an image is submitted, it will be moderated and the result 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 |
|---|---|---|---|
type |
Number | Required | Image content type: 1: image URL; 2: image BASE64 value |
image |
String | Required | Image content. When type=1 it is the image URL; when type=2 it is the image BASE64 value |
strategyId |
String | Optional | Strategy ID; uses default strategy DEFAULT when not provided |
checkTags |
List<Number> | Optional | Restrict detection categories, supports first-level categories enabled in the strategy |
referImage |
String | Optional | Reference image for face comparison, type must match image. Supported formats: jpg, png; size < 10M |
userId |
String | Optional | Unique end user ID, no more than 32 characters |
extra |
Object | Optional | Extension fields transparently passed through, multiple key/value pairs. 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 |
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 |
Request Example
{
"type": 1,
"image": "http://abc.com/a.jpg",
"userId": "123",
"callbackUrl": "http://your.callback.url/callback",
"callbackSecretKey": "your-callback-secret"
}
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/check/async |
HTTP Response
Content-Type: application/json;charset=UTF-8
The result is in JSON format.
Response Fields
| Field | Type | Description |
|---|---|---|
errorCode |
Number | Error code: 0 means success |
errorMessage |
String | Error message |
taskId |
String | Task ID, used to query the result or associate with the callback |
Response Example
{
"errorCode": 0,
"taskId": "ap_99b2bf004d4a4591bfedbba9574e74d4_1702882338368"
}
Error Codes
See Common Error Codes in Help Center