async checkresult

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/asynccheckresult
API Description: This API is used to query the detection result of a GenAI Detection asynchronous task. After a task is submitted via the asyncdetect API, a transactionId is obtained, which is then used to call this API in a polling manner to obtain the detection conclusion.

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.
transactionId	String	64	-	Required. The transaction ID of the task to be queried, which is returned by the GenAI Detection asyncdetect API.

Response Parameters

Field name	Data type	Description
result	Result	Required. The result of the API request, including the result status, result code, and result message.
mediaType	String	Optional. The media type. Valid values: + `IMAGE`: image + `VIDEO`: video Note: This field is returned only when `result.resultCode` is `SUCCESS`.
overallResult	String	Optional. The overall detection conclusion. Valid values: + `GEN_AI`: AI-generated content (deepfake/AIGC) + `REAL`: real content Note: This field is returned only when `result.resultCode` is `SUCCESS`.
visualResult	String	Optional. The detection conclusion of the visual dimension. Valid values: + `GEN_AI`: AI-generated content + `REAL`: real content Note: This field is returned only when `result.resultCode` is `SUCCESS`.

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 asynccheckresult API.

resultCode	resultStatus	Description
PROCESSING	S	The detection task is still being processed. Call this API again later.
UNSUPPORTED_FILE_FORMAT	F	The file format is not supported, or the file format is inconsistent with `mediaType`.
RESOLUTION_TOO_SMALL	F	The resolution of the image or video is too low.
DURATION_EXCEEDED	F	The video duration exceeds the limit.
NO_CONTENT_DETECTED	F	No recognizable content is detected.

Sample

Request Sample

copy
{
    "bizId": "2017839040588699",
    "transactionId": "G000000006FGAD20261022120012123400040771"
}

Response Sample

Task still being processed, continue polling:

copy
{
    "result": {
        "resultStatus": "S",
        "resultCode": "PROCESSING",
        "resultMessage": "It is still under processing"
    }
}

Detection completed (the frames of the video are real content):

copy
{
    "result": {
        "resultStatus": "S",
        "resultCode": "SUCCESS",
        "resultMessage": "Success"
    },
    "mediaType": "VIDEO",
    "overallResult": "REAL",
    "visualResult": "REAL"
}

Task not found or not owned by the current merchant:

copy
{
    "result": {
        "resultStatus": "F",
        "resultCode": "INVALID_ARGUMENT",
        "resultMessage": "transactionId is not found"
    }
}

Task timed out:

copy
{
    "result": {
        "resultStatus": "F",
        "resultCode": "PROCESS_TIMEOUT",
        "resultMessage": "Processing timed out"
    }
}