全部产品
Search

搜索本产品

    ID Verification：FACE_DEEPFAKE

    文档中心

    ID Verification：FACE_DEEPFAKE

    更新时间：Jan 14, 2026

    人脸深度伪造（Deepfake）检测接口（DeepfakeDetectIntl / DeepfakeDetectIntlStream）用于分析输入的人脸图像或视频，可有效识别包括AIGC生成人脸、深度伪造换脸、模板攻击及翻拍等风险场景，并输出相应的风险标签与置信度分数。

    接口信息

    人脸深度伪造检测服务分析输入的人脸图像或视频，以识别潜在的深度伪造风险。该服务提供以下两种接口，以支持不同的数据提交方式：

    DeepfakeDetectIntlStream

    支持以文件流（File Stream）的形式直接上传图像或视频数据，适用于需要直接处理本地文件的场景。

    • 请求方法：HTTPS POST

    • QPS限量：API独享QPS限量，详情请参见ID Verification服务端API QPS限量说明。

    • 服务地址：

      说明

      • 内网访问优势：内网指阿里云同一地域内各产品间的私有通信网络。若您的业务服务器部署于阿里云对应地域，请使用内网域名访问 ID Verification 服务，以获得更安全、稳定的通信质量。 

      • 海外访问优化建议：海外网络环境复杂，建议参考服务端网络耗时分析与优化，优化集成方案，降低网络延迟及请求失败概率。

      新加坡

      • 公网：cloudauth-intl.ap-southeast-1.aliyuncs.com

      • 内网：cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com

    DeepfakeDetectIntl

    用于通过公网 URL 或 Base64 字符串提交图像或视频数据。

    • 请求方法：HTTPS POST

    • QPS限量：API独享QPS限量，详情请参见ID Verification服务端API QPS限量说明。

    • 服务地址：

      说明

      • 内网访问优势：内网指阿里云同一地域内各产品间的私有通信网络。若您的业务服务器部署于阿里云对应地域，请使用内网域名访问 ID Verification 服务，以获得更安全、稳定的通信质量。 

      • 海外访问优化建议：海外网络环境复杂，建议参考服务端网络耗时分析与优化，优化集成方案，降低网络延迟及请求失败概率。

      新加坡

      • 公网：cloudauth-intl.ap-southeast-1.aliyuncs.com

      • 内网：cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com

    在线调试和集成

    说明

    在调试和集成前，请确保您已完整阅读使用OpenAPI调试和集成服务端API文档，充分了解API接口在OpenAPI平台的调用方式和SDK及其代码的获取方式。

    图片和视频要求

    说明

    以下对于图片和视频的要求，均适用于DeepfakeDetectIntlStream和DeepfakeDetectIntl接口。

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

    图片

    • 图片格式：JPG，JPEG。

    • 图片大小：推荐50~100 KB，最大不超过10 MB（建议超过1MB的图片可以通过URL方式上传）。

    • 图片分辨率：建议640*480（高*宽），不超过1920*1080（高*宽），且保持照片的高大于宽。推荐短边缩放到720像素，压缩率0.8。

    • 图片质量：照片清晰、曝光正常，脸部无过黑、过亮、光晕等情况。

    • 图片人脸：当图片出现多个人脸时，系统将默认检测图中面积最大的人脸。

    视频

    • 视频格式：MP4、MOV。

    • 视频大小：体积 > 100KB，最大不超过10MB（若视频超过1MB，建议通过URL方式上传）。

    • 视频长度：1~3秒。

    • 视频分辨率：建议640*480（高*宽）。

    • 视频帧率：8 帧或8 帧以上。

    说明

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

    请求参数

    名称

    类型

    必填

    描述

    示例值

    ProductCode

    string

    是

    要接入的产品方案。

    取值：FACE_DEEPFAKE

    FACE_DEEPFAKE

    SceneCode

    string

    是

    您自定义的认证场景ID，用于后续控制台输入此场景ID查询相关记录使用。

    支持长度为10位的字母、数字或下划线的组合。

    1234567890

    MerchantBizId

    string

    是

    商户请求的唯一标识，值为32位长度的字母数字组合。

    其中前几位字符由商户自定义的简称组成，中间部分可以包含一段时间，而后段可以采用随机或递增序列。

    e0c34a77f5ac40a5aa5e6ed20c******

    FaceInputType

    string

    否

    人脸素材输入类型：

    • IMAGE（默认）：人脸图片

    • VIDEO：人脸视频

      说明

      视频处理时间较久，建议超时时间设置>3S。

    IMAGE

    FaceUrl

    string

    否

    • DeepfakeDetectIntl：支持通过 FaceUrl 或 FaceBase64 提交数据，二者须选其一。

    • DeepfakeDetectIntlStream：支持通过 FaceUrl、FaceBase64 或 FaceFile 提交数据，三者须选其一。

    传入人脸图片或视频URL地址。

    https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/verify/xxxxx/xxxxx.jpeg

    FaceBase64

    string

    传入人脸图片的Base64格式编码，视频格式建议通过URL方式传入。

    /9j/4AAQSkZJRgABAQAASxxxxxxx

    FaceFile

    string

    人脸图片或视频文件流

    返回参数

    名称

    类型

    描述

    示例值

    RequestId

    String

    请求ID。

    8FC3D6AC-9FED-4311-8DA7-C4BF47D9****

    Code

    String

    返回码。

    Success

    Message

    String

    返回Code的详细描述。

    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",
 "SuspectTemple":"0.9500"
 }

    返回码

    HTTP Status Code

    Code

    描述

    200

    Success

    请求成功。

    400

    MissingParameter

    参数不能为空。

    400

    InvalidParameter

    非法参数。

    401

    NoFaceDetected

    自定义比对源的图片人脸特征提取失败，建议更换图片上传。

    401

    UnqualifiedPhoto

    传入的图片不可读，或图片分辨率不符合要求，建议更换图片。需确保照片清晰、曝光正常，完整无遮挡，角度无太大偏差。

    401

    ToolargeImage

    图片尺寸过大，建议压缩图片或更换图片上传方式。

    401

    DataDuplication

    同时通过Base64方式与链接方式传入图片。

    401

    DownloadTimeout

    URL图片下载超时。

    403

    Forbidden.RAMUserAccessDenied

    需要给RAM用户授予AliyunAntCloudAuthFullAccess的操作权限。更多信息，请参见授权RAM用户访问服务。

    403

    Forbidden.AccountAccessDenied

    确保您开通了ID verification，并且保证账户未欠费。

    403

    Throttling.Api

    API限流拦截。

    500

    InternalError

    系统内部错误，请反馈工程师排查。