async detect

2026-11-12 01:17

概览

API URL：/api/v1/zoloz/genaidetection/asyncdetect
API 描述：该接口用于以异步方式提交 GenAI 检测任务（AI 生成内容/深度伪造检测），覆盖图片和视频画面。接口受理成功后立即返回唯一的transactionId，商户随后可通过asynccheckresult API轮询查询检测结果。

请求参数

字段名称	数据类型	最大长度	是否必填	默认值	描述	示例值
bizId	String	32	是	-	业务ID，业务的唯一标识，用于追踪业务。例如，商户业务相关数据库中的序列号。说明：ZOLOZ服务器不检查该字段的值是否唯一。为了更便捷地追踪业务，建议开启商户服务器，并确保业务ID的唯一性。对于本接口，该字段同时作为幂等键，系统按（商户ID + bizId）进行幂等处理，幂等数据保留7天。	"2018110812000001"
userId	String	64	否	null	商户的用户ID或其他可用于识别某一用户的标识，例如手机号码、电子邮件地址等。建议对userId字段的值进行预脱敏，例如进行哈希处理。	"123456abcd"
mediaType	String	16	是	-	媒体类型。取值如下： + `IMAGE`：图片。 + `VIDEO`：视频。	"VIDEO"
fileContent	String	解码后 ≤ 10MB	是	-	待检测文件的 Base64 编码内容。注意： + 内容必须是有效的 Base64 编码，且解码后不得超过10MB。 + 图片支持png、jpg、jpeg、bmp，视频支持mp4，文件格式须与`mediaType`匹配。 + 图片分辨率要求长边 ≥ 320、短边 ≥ 240，视频分辨率要求长边 ≥ 640、短边 ≥ 480。 + 视频时长不得超过5分钟。	"AAAAIGZ0eXBpc29tAAACAGlzb21..."
originalFileName	String	-	是	-	原始文件名，必须包含扩展名。扩展名须与`mediaType`匹配：图片支持png、jpg、jpeg、bmp，视频支持mp4。	"test.mp4"

返回参数

字段名称	数据类型	必须返回	描述	示例值
result	Result	是	API请求结果，包含结果状态、结果码和结果消息。	{ "resultStatus": "S", "resultCode": "SUCCESS", "resultMessage": "Task accepted" }
transactionId	String	否	ZOLOZ服务器为本次异步检测任务生成的唯一事务ID，用于调用GenAI Detection asynccheckresult API查询检测结果。说明：仅当检测任务提交成功时返回该字段。	"G000000006FGAD20261022120012123400040771"

处理结果

API通用结果码

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

API特有结果码

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

结果码	结果状态	描述
SUCCESS	S	检测任务提交成功。
UNSUPPORTED_FILE_FORMAT	F	文件格式不支持。
FILE_SIZE_EXCEEDED	F	文件大小超过10MB。

说明：媒体格式、分辨率和时长等内容校验在任务执行阶段完成，相关结果请通过 GenAI Detection asynccheckresult API 查询。

代码示例

请求示例

异步提交视频检测任务：

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

异步提交图片检测任务：

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

返回示例

受理成功：

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