全部產品
Search

搜尋本產品

    ID Verification：CREDENTIAL_DETECT

    文件中心

    ID Verification：CREDENTIAL_DETECT

    更新時間：Dec 18, 2025

    本文介紹憑證檢測服務的API介面。傳入憑證圖片資訊，返回是否偽造、篡改，截屏，翻拍等風險。

    介面資訊

    • 介面名：CredentialVerifyIntl

    • 介面說明：傳入憑證圖片資訊，返回是否偽造、篡改，截屏，翻拍等風險。

    • 要求方法：POST

    • 傳輸協議：HTTPS

    • QPS限量：API獨享QPS限量，詳情請參見ID Verification服務端API QPS限量說明。

    • 服務地址：

      說明

      內網指的是阿里雲同地區產品之間的內部通訊網路，如果您的商務服務器部署在阿里雲的對應地區，可以通過內網網域名稱訪問 ID Verification 服務，以獲得更安全、穩定的網路通訊品質。

      新加坡

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

      • 內網：cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com

    說明

    1. 憑證檢測屬於AI預測類產品，自我裝載集樣本準確率是90%，實際準確率由於樣本情境的差異可能有波動。

    2. 電子合成圖片類圖片PS檢測難度較大，原生相機拍攝圖片檢測效果優於電子合成圖片。

    3. 憑證檢測結果不建議作為憑證真實性判斷的唯一方法，可作為輔助審核依據，或作為人工審核提效工具。

    4. 憑證檢測在金融支付收單、電商商家入駐等電子資料審核情境已經得到廣泛的運用，有效提升人審效率，如果您有更廣泛情境需求，請聯絡您的商務經理。

    線上調試和整合

    說明

    在調試和整合前，請確保您已完整閱讀使用OpenAPI調試和整合服務端API文檔，充分瞭解API介面在OpenAPI平台的調用方式和SDK及其代碼的擷取方式。

    您可以在OpenAPI Explorer中直接運行本介面進行調試，並產生本介面的SDK程式碼範例。

    請求參數

    參數ImageUrl或ImageFileObject對應的圖片必須符合以下規則：

    • 圖片格式：支援PNG、JPG、JPEG、BMP和WebP格式。

    • 圖片尺寸：圖片長寬需要大於15像素，小於8192像素，且長寬比需要小於50。

      說明

      為了確保較好的識別效果，建議映像的長寬均大於500像素。

    • 圖片大小：URL格式傳入，不能超過10MB；ImageFileObject傳入，不能超過3MB。

      說明

      圖片過大會影響介面響應速度，建議使用小於 3MB圖片。

    名稱

    類型

    是否必選

    描述

    樣本值

    CredType

    String

    是

    憑證類型：

    • 03：企業資質類

    • 04：交易憑據類

    03

    CredName

    String

    是

    憑證名稱（取數字代碼）：

    • 03開頭，企業資質類：

      • 0301：中國內地工商營業執照

    • 04開頭，交易憑據

      • 0401：銀行流水

      • 0402：薪資條

      • 0403：水電賬單

      • 0405：信用卡賬單

      • 0499：其他

    說明

    如果您需要支援更多的憑證類型，請聯絡您的商務經理。

    0301

    ProductCode

    String

    是

    調用模式：

    • ANTI_FAKE_CHECK：圖片品質、篡改檢測。

    ANTI_FAKE_CHECK

    ImageUrl

    String

    是

    重要

    imageUrl與ImageFileObject任選一個。

    圖片的地址。

    無

    ImageFileObject

    InputStream

    圖片輸入資料流。

    無

    響應參數

    名稱

    類型

    描述

    樣本值

    RequestId

    String

    請求ID。

    130A2C10-B9EE-4D84-88E3-5384********

    Code

    String

    返回Code。

    重要

    • 此參數代表是否正確調用了介面，詳細的返回碼說明請參見錯誤碼。

    • 業務核驗結果請通過ResultObject中的欄位查看。

    Success

    Message

    String

    返回Code的詳細描述。

    success

    ResultObject

    Result

    String

    • 0：低風險

    • 1：高風險

    • 2：可疑

    1

    RiskTag

    String

    風險標籤，多個標籤用英文逗號隔開，包括：

    • PS：圖片PS

    • SCREEN_PHOTO：螢幕翻拍

    • SCREENSHOT：螢幕截屏

    • ORIGINAL_PHOTO：非原始圖

    PS

    RiskScore

    Map<String,String>

    命中標籤演算法預測風險分值，取值範圍為0至1。1表示演算法識別到風險，0表示演算法未檢測到風險。

    {
  "PS": "0.0211",
  "SCREEN_PHOTO": "0.0101",
  "SCREENSHOT": "0.0521",
  "ORIGINAL_PHOTO": "0.0861"
}

    MaterialInfo

    String

    其他資訊，預留欄位。

    返回Code

    HTTP 狀態代碼

    Code

    描述

    200

    Success

    請求成功。

    400

    MissingParameter

    參數不可為空。

    400

    Forbidden.ExceptionRepeatedInvoke

    異常重複調用。

    401

    InvalidParameter

    非法參數。

    401

    UnqualifiedPhoto

    傳入圖片不可用

    401

    ToolargeImage

    傳入圖片過大

    401

    DataDuplication

    資料重複

    403

    Forbidden.AccountAccessDenied

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

    403

    Forbidden.RAMUserAccessDenied

    需要給RAM使用者授予 AliyunAntCloudAuthFullAccess 的操作許可權。

    500

    Forbidden.ExceptionDataSource

    權威源服務異常。

    500

    InternalError

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