全部產品
Search

搜尋本產品

    ID Verification：FACE_DEEPFAKE

    文件中心

    ID Verification：FACE_DEEPFAKE

    更新時間：Dec 11, 2025

    人臉深度偽造（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狀態代碼

    Code

    Message描述

    200

    Success

    請求成功。

    400

    MissingParameter

    參數不可為空。

    InvalidParameter

    非法參數。

    TransactionIdInvalid

    無效Transaction id。

    403

    Forbidden.RAMUserAccessDenied

    需要給RAM使用者授予AliyunAntCloudAuthFullAccess的操作許可權。更多資訊，請參見授權RAM使用者訪問服務。

    Forbidden.AccountAccessDenied

    確保您開通了ID verifycation，並且保證賬戶未欠費。

    Throttling.Api

    API限流攔截。

    404

    ProcessNotCompleted

    整個認證流程未完成。

    500

    InternalError

    系統內部錯誤，請反饋工程師排查。

    503

    ServiceUnavailable

    服務不可用，請反饋工程師排查。