全部產品
Search

搜尋本產品

    ID Verification：CREDENTIAL_DETECT

    文件中心

    ID Verification：CREDENTIAL_DETECT

    更新時間：Jul 08, 2026

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

    介面資訊

    • 介面名：CredentialVerifyIntl

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

    • 要求方法：POST

    • 傳輸協議：HTTPS

    • QPS限量：API獨享QPS限量，詳情請參見服務端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介面在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任選一個。

    圖片的地址。

    https://example.com/test.jpg

    ImageFileObject

    InputStream

    圖片檔案流。

    使用此方式上傳時，需通過雲產品提供的 Advance 介面進行調用，並傳入有效 InputStream 對象。具體實現，請參見特殊情境：檔案上傳 Advance 介面配置。

    圖⽚的InputStream對象

    響應參數

    名稱

    類型

    描述

    樣本值

    RequestId

    String

    請求ID。

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

    Code

    String

    返回Code，具體資訊請參見服務端返回HTTP狀態代碼說明。

    重要

    • 此參數代表是否正確調用了介面。

    • 業務核驗結果請通過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

    其他資訊，預留欄位。