async detect

2026-11-11 08:07

Important Notice:

All request and response parameters are strictly subject to the official API documentation.
The API response may contain fields not defined in the documentation. These fields are for internal debugging purposes only and are not guaranteed to be stable or compatible. Do not rely on these fields in production environments. ZOLOZ reserves the right to modify or remove these fields at any time without prior notice.

Overview

API URL: /api/v1/zoloz/genaidetection/asyncdetect
API Description: This API is used to submit a GenAI detection task (AI-generated content/deepfake detection) asynchronously, covering images and video frames. Once the task is accepted, the API immediately returns a unique transactionId, and the merchant can then poll for the detection result via the asynccheckresult API.

Request Parameters

Field name	Data type	Max length	Default Value	Description
bizId	String	32	-	Required. The business ID, a unique identifier of the merchant's business, used for tracing business. For example, the sequence ID from the merchant's business-related database. Note: The ZOLOZ server does not validate the uniqueness of this value. To trace business more conveniently, it is recommended that the merchant enable its own server and ensure the uniqueness of the business ID. For this API, this field also serves as the idempotency key: idempotency is processed based on (merchant ID + bizId), and idempotent data is retained for 7 days.
userId	String	64	null	Optional. The merchant's user ID, or other identifiers that can be used to identify a specific user, for example, a mobile phone number, email address, etc. It is recommended to pre-desensitize the value of the userId field, for example, by hashing the value.
mediaType	String	16	-	Required. The media type. Valid values: + `IMAGE`: image + `VIDEO`: video
fileContent	String	10MB	-	Required. The Base64-encoded content of the file to be detected. Note: + The content must be valid Base64 encoding, and must not exceed 10MB after decoding. + For images, png, jpg, jpeg, and bmp are supported; for videos, mp4 is supported. The file format must match the declared `mediaType`. + For images, the resolution must be no less than 320 on the long edge and 240 on the short edge; for videos, the resolution must be no less than 640 on the long edge and 480 on the short edge. + The video duration must not exceed 5 minutes.

Response Parameters

API-Common Result Codes

For the full list of common error codes, see the Common error codes section in the Error handling topic.

API-Specific Result Codes

The following table lists result codes specific to the GenAI Detection asyncdetect API.

resultCode	resultStatus	Description
SUCCESS	S	The detection task is submitted successfully.
UNSUPPORTED_FILE_FORMAT	F	The file format is not supported.
FILE_SIZE_EXCEEDED	F	The file size exceeds 10MB.

Note: Media content validations such as file format, resolution, and duration are completed during the task execution stage. Check the related results via the GenAI Detection asynccheckresult API.

Sample

Request Sample

Submit an asynchronous video detection task:

copy
{
    "bizId": "2018110812000002",
    "userId": "123456abcd",
    "mediaType": "VIDEO",
    "fileContent": "AAAAIGZ0eXBpc29tAAACAGlzb21..."
}

Submit an asynchronous image detection task:

copy
{
    "bizId": "2018110812000004",
    "userId": "123456abcd",
    "mediaType": "IMAGE",
    "fileContent": "/9j/4AAQSkZJRgABAQ..."
}

Response Sample

Task accepted:

copy
{
    "result": {
        "resultStatus": "S",
        "resultCode": "SUCCESS",
        "resultMessage": "Task accepted"
    },
    "transactionId": "G000000006FGAD20261022120012123400040771"
}