调用人脸Deepfake检测服务API-实人认证-阿里云

本文介绍人脸Deepfake检测服务的API。

接口信息

重要

在使用本接口前，请确保已完整阅读接入流程，并开通服务。

服务地址（调用 API 时的 Endpoint）：

地域	IPv4	IPv6
通用	cloudauth.aliyuncs.com	cloudauth-dualstack.aliyuncs.com
北京	cloudauth.cn-beijing.aliyuncs.com	cloudauth-dualstack.cn-beijing.aliyuncs.com
上海	cloudauth.cn-shanghai.aliyuncs.com	cloudauth-dualstack.cn-shanghai.aliyuncs.com

说明

说明

人脸Deepfake检测接口当前处于商业化阶段，免费公测的截止时间为2024年8月30日23:59:59。公测结束后调用成功的请求系统将推送计量，详情请参见人脸deepfake计费。

Deepfake检测算法通常配合业务、设备、行为等多维度数据综合处理，适用于已经有人脸检测SDK期望增强伪造人脸检出能力的场景。为了确保模型效果稳定，您需要确保传入人脸检测SDK前置摄像头采集的人脸图片或视频，且该人脸的角度正常。此外，还需要满足以下条件：

说明

视频场景下，基于Qwen大模型处理性能，默认截取视频中8帧提交模型处理，建议避免传入无效视频影响检测。

名称	类型	必填	描述	示例值
OuterOrderNo	String	是	商户请求的唯一标识，值为32位长度的字母数字组合。其中前几位字符由商户自定义的简称组成，中间部分可以包含一段时间，而后段可以采用随机或递增序列。	e0c34a77f5ac40a5aa5e6ed20c******
FaceInputType	String	否	人脸素材输入类型： IMAGE（默认）：人脸图片 VIDEO：人脸视频说明视频处理时间较久，建议超时时间设置>3S。	IMAGE
FaceUrl	String	是说明 FaceUrl和FaceBase64任选其一。	传入人脸图片或视频URL地址。	https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/verify/xxxxx/xxxxx.jpeg
FaceBase64	String	是说明 FaceUrl和FaceBase64任选其一。	传入人脸图片的Base64格式编码，视频格式建议通过URL方式传入。	/9j/4AAQSkZJRgABAQAASxxxxxxx

名称		类型	描述	示例值
RequestId		String	请求ID。	8FC3D6AC-9FED-4311-8DA7-C4BF47D9F260
Code		String	返回码：返回200表示请求成功，其他均为失败。重要此参数代表是否正确调用了接口，详细的返回码说明请参见服务端错误码。业务核验结果请通过ResultObject中的字段查看。	200
Message		String	返回信息。	success
ResultObject	Result	String	风险结果： 0：低风险 1：高风险 2：可疑	1
	RiskTag	String	风险标签。多个标签使用半角逗号（,）隔开，包括： SuspectDeepForgery：疑似深度伪造 SuspectPSFace：疑似合成攻击 SuspectTemple：疑似模板攻击 SuspectRemake：疑似翻拍人脸	SuspectDeepForgery
	RiskScore	Map	风险分值Map。	`{ "SuspectPSFace": "0.9796", "SuspectRemake": "0.0000", "SuspectDeepForgery": "0.9500" }`

重要

集成前请确保您已完整阅读接入流程，开通了服务并获取AccessKey且正确配置环境变量。

关于SDK示例和安装包获取：

您可以在OpenAPI的在线接口调试页面的右侧找到对应的SDK调用示例，并在代码示例的右上角点击SDK安装信息查看SDK的安装信息。
说明
注意选择所需的编程语言。
如果您有离线安装的需求，可以进入SDK安装页面选择需要语言的SDK，并转到发布地址获取。