async checkresult

2026-11-12 01:17

概览

API URL：/api/v1/zoloz/genaidetection/asynccheckresult
API 描述：该接口用于查询 GenAI Detection 异步检测任务的检测结果。使用 asyncdetect API 提交任务后获得 transactionId，随后使用该 transactionId 轮询调用本接口获取检测结论。

请求参数

字段名称	数据类型	最大长度	是否必填	默认值	描述	示例值
bizId	String	32	是	-	业务ID，业务的唯一标识，用于追踪业务。例如，商户业务相关数据库中的序列号。说明：ZOLOZ服务器不检查该字段的值是否唯一。为了更便捷地追踪业务，建议开启商户服务器，并确保业务ID的唯一性。	"2017839040588699"
transactionId	String	64	是	-	待查询任务的事务ID，由GenAI Detection asyncdetect API返回。	"G000000006FGAD20261022120012123400040771"

返回参数

字段名称	数据类型	必须返回	描述	示例值
result	Result	是	API请求结果，包含结果状态、结果码和结果消息。	{ "resultStatus": "S", "resultCode": "SUCCESS", "resultMessage": "Success" }
mediaType	String	否	媒体类型。取值如下： + `IMAGE`：图片。 + `VIDEO`：视频。说明：仅当`result.resultCode`为`SUCCESS`时，才返回该字段。	"VIDEO"
overallResult	String	否	整体检测结论。取值如下： + `GEN_AI`：AI生成内容（深度伪造/AIGC）。 + `REAL`：真实内容。说明：仅当`result.resultCode`为`SUCCESS`时，才返回该字段。	"GEN_AI"
visualResult	String	否	画面维度的检测结论。取值如下： + `GEN_AI`：AI生成内容。 + `REAL`：真实内容。说明：仅当`result.resultCode`为`SUCCESS`时，才返回该字段。	"REAL"

处理结果

API通用结果码

有关通用结果码的完整列表，请参见API通用结果码。

API特有结果码

GenAI Detection asynccheckresult API的结果码见下表。

结果码	结果状态	描述
PROCESSING	S	检测任务仍在处理中，请稍后再次查询。
UNSUPPORTED_FILE_FORMAT	F	文件格式不支持，或文件格式与`mediaType`不一致。
RESOLUTION_TOO_SMALL	F	图片或视频分辨率过低。
DURATION_EXCEEDED	F	视频时长超过限制。
NO_CONTENT_DETECTED	F	未检测到可识别的内容。

代码示例

请求示例

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

返回示例

任务处理中，继续轮询：

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

检测完成（视频画面为真实内容）：

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

任务不存在或不属于当前商户：

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

任务超时：

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