本文介绍人脸Deepfake检测服务的API。
接口信息
接口名:DeepfakeDetect
全局接入地址:cloudauth.aliyuncs.com(IPv4)或cloudauth-dualstack.aliyuncs.com(IPv6)
接口说明:传入人脸图片,通过算法检测是否存在深度伪造风险。包含AIGC生成人脸、深度伪造换脸、模板人脸、翻拍人脸等风险场景,输出风险标签与置信度。
QPS限量:API独享QPS限量,详情请参见信息核验接口QPS限量说明。
人脸Deepfake检测接口当前处于免费公测阶段,免费公测的截止时间为2024年8月30日23:59:59。公测结束后调用成功的请求系统将推送计量,详情请参见人脸deepfake计费。
图片要求
为了确保模型效果稳定,您需要确保传入的图片中为人脸图片且该人脸的角度正常。此外,还需要满足以下条件:
图片格式:JPG,JPEG。
图片大小:推荐50~100 KB,最大不超过1 MB。
图片分辨率:建议640*480(高*宽),不超过1920*1080(高*宽),且保持照片的高大于宽。推荐短边缩放到720像素,压缩率0.8。
图片质量:照片清晰、曝光正常,脸部无过黑、过亮、光晕等情况。
图片人脸:当图片出现多人脸,系统会默认检测最大脸。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
OuterOrderNo | String | 是 | 商户请求的唯一标识,值为32位长度的字母数字组合。其中前几位字符由商户自定义的简称组成,中间部分可以包含一段时间,而后段可以采用随机或递增序列。 | e0c34a77f5ac40a5aa5e6ed20c****** |
FaceInputType | String | 否 | 默认传IMAGE,表示人脸图像。 | IMAGE |
FaceUrl | String | 是 说明 FaceUrl和FaceBase64任选其一。 | 传入人脸图片URL地址。 | https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/verify/xxxxx/xxxxx.jpeg |
FaceBase64 | String | 传入人脸图片的Base64格式编码。 | /9j/4AAQSkZJRgABAQAASxxxxxxx |
响应参数
名称 | 类型 | 描述 | 示例值 | |
RequestId | String | 请求ID。 | 8FC3D6AC-9FED-4311-8DA7-C4BF47D9F260 | |
Code | String | 返回码:返回200表示请求成功,其他均为失败。 重要
| 200 | |
Message | String | 返回信息。 | success | |
ResultObject | Result | String | 风险结果:
| 1 |
RiskTag | String | 风险标签。多个标签使用半角逗号(,)隔开,包括:
| SuspectDeepForgery,SuspectWarterMark | |
RiskScore | Map | 风险分值Map。 |
|
SDK调用示例
集成前请确认您已获取AccessKey,并已配置环境变量。具体操作,请参见:
接口在线调试和SDK示例:OpenAPI平台