全部產品
Search

搜尋本產品

    ID Verification：ID_OCR_MAX

    文件中心

    ID Verification：ID_OCR_MAX

    更新時間：Jul 11, 2026

    ID_OCR_MAX 是 ID Verification 基於Qwen-VL大模型推出的卡證識別方案，支援全球多種身份證件類型檢測與識別。

    重要

    受地區模型限制，不同地區支援識別的證件類型不一致。

    • 新加坡地區：支援識別證件類型表中的證件。

    • 印尼地區：僅支援識別印尼身份證和全球護照（證件類型編碼IDN01001和GLB03002）。

    • 馬來西亞地區：僅支援識別馬來西亞身份證和全球護照（證件類型編碼MYS01001和GLB03002）

    服務地址

    • 介面名：DocOcrMaxV2

    • 介面說明：傳入證件圖片資訊，介面會基於Qwen-VL大模型識別證件類型和證件資訊，並返回相關欄位。

    • 要求方法： POST

    • 傳輸協議：HTTPS

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

    • 服務地址：

      說明

      • 內網訪問優勢：內網指阿里雲同一地區內各產品間的私人通訊網路。若您的商務服務器部署於阿里雲對應地區，請使用內網網域名稱訪問 ID Verification 服務，以獲得更安全、穩定的通訊品質。 

      • 海外訪問最佳化建議：海外網路環境複雜，建議參考服務端網路耗時最佳化，最佳化整合方案，降低網路延遲及請求失敗機率。

      新加坡

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

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

      印尼

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

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

      馬來西亞（吉隆坡）

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

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

    線上調試和整合

    說明

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

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

    傳入圖片格式要求

    為了確保模型效果穩定，請傳入滿足以下所有條件的圖片：

    • 圖片格式：JPG、JPEG、PNG。

    • 圖片大小：推薦50~100 KB，最大不超過10 MB。

      說明

      圖片轉base64格式後，通常會導致資料體積增加。如您需要使用base64格式傳參，請保證原始圖片的體積不超過6MB，以滿足10MB的最巨量資料傳輸限制。

    • 圖片解析度：圖片長寬需要大於 200像素，小於 8192 像素，推薦480*640（高*寬）。

    • 圖片品質建議：

      • 卡證圖片需要保持四個邊角完整，避免手持時遮擋影響檢測。

      • 卡證圖片內容清晰、無遮擋和無曝光光斑，卡證圖片角度正常，避免傾斜或者倒置。

      • 卡證圖片面積需要佔比圖片面積60%以上，避免卡面圖片面積過小影響識別。

      • 建議採用真實證件拍攝。

    請求參數

    名稱

    類型

    是否必選

    描述

    樣本值

    ProductCode

    String

    是

    要接入的產品方案。取值ID_OCR_MAX。

    ID_OCR_MAX

    SceneCode

    String

    否

    您自訂的認證情境ID，用於後續控制台輸入此情境ID查詢相關記錄。

    支援長度為10位的字母、數字和底線的組合。

    1234567890

    MerchantBizId

    String

    是

    您自訂的業務唯一標識，用於後續定位排查問題。

    支援長度為32位的字母和數位組合，請確保唯一。

    e0c34a77f5ac40a5aa5e6ed20c35****

    MerchantUserId

    String

    否

    您自訂的使用者ID，或者其他可以識別特定使用者的標識，例如：手機號碼、郵箱地址等。

    強烈建議對該欄位的值進行預先脫敏，例如對值進行雜湊處理。

    123456789

    IdOcrPictureBase64

    String

    否，三種上傳方式任選其一即可。

    卡證圖片Base64編碼。

    如果您選擇IdOcrPictureBase64（照片Base64編碼）方式傳入證件照片，請注意檢查照片大小，不要傳入過大的照片。

    base64

    IdOcrPictureUrl

    String

    卡證圖片地址，公網可訪問的HTTP、HTTPS連結。

    https://***.jpg

    IdOcrPictureFile

    InputStream

    證件圖片檔案流。

    具體接入方式，請參見特殊情境：檔案上傳 Advance 介面配置。

    OcrModel

    String

    否

    OCR識別模式：

    說明

    模式1、2 不支援證件品質檢測和防偽檢測，詳情請參見：不同識別模式差異說明。

    • 0：指定證件識別模式（預設）

    • 1：證件自動分類模式

    • 2：證件自動分類+通用識別模式

    0

    DocType

    String

    否

    證件類型

    說明

    • OcrModel = 0：DocType必傳，指定證件類型。

    • OcrModel = 1或2：DocType需要為空白。

    GLB03001

    DocPage

    String

    否

    期望識別的頁面

    • 01（預設）：證件人像面

    • 02：證件背面

    重要

    若模型檢測與指定識別頁面不符，將返回Subcode：213。

    01

    IdSpoof

    String

    否

    是否開啟證件防偽功能：

    • T：開啟

    • F（預設）：不開啟

    F

    IdThreshold

    String

    否

    自訂OCR品質檢測閾值模式：

    • 1：strict 模式

    • 2：寬鬆模式

    • 3：關閉品質檢測（預設）

    3

    OcrValueStandard

    String

    否

    是否需要額外返回OCR識別標準化格式欄位：

    • 0：否 （預設）

    • 1：是

    說明

    支援的證件類型、標準化欄位，詳情請參見：欄位標準化功能說明。

    0

    Authorize

    String

    否

    是否啟用權威資料來源核驗以增強證件防偽能力。僅當IdSpoof參數設定開啟時，該參數適用。

    • T：啟用

    • F：不啟用（預設）

    說明

    • 適用證件類型：中國居民身份證（CHN01001）、中國內地駕駛證（CHN02001）。

    • 資料轉送聲明：啟用此參數，即表示同意將使用者的姓名和證件號碼傳輸至中國內地權威資料來源進行一致性校正。

    • 效能影響：啟用後，介面回應時間將增加約 1-2 秒。建議調整逾時時間設定。

    • 驗證結果：啟用後，若資訊核驗不一致，系統將返回認證失敗 Subcode212。

    T

    不同識別模式差異說明

    OCR識別模式

    輸入差異

    輸出差異

    建議適用情境

    0：指定證件識別模式

    • 需要輸入指定證件類型和頁面。

      當前支援的識別證件類型和頁面參考：證件類型表

    • 可選開啟品質和防偽檢測

    輸出證件頁面詳細欄位，詳情參考：證件OCR欄位表

    ID Verification線上准入情境，自動化校正證件類型是否業務允許，並輸出卡面詳細欄位。

    1：證件自動分類模式

    重要

    僅新加坡地區支援該識別模式。

    • 無需指定證件類型

    • 不支援品質和防偽檢測

    僅輸出檢測的證件類型編碼，詳情參考：全球卡證編碼。

    離線業務分析情境，用於歷史卡證圖片聚類清洗。

    2：證件自動分類並通用識別模式

    重要

    僅新加坡地區支援該識別模式。

    • 無需指定證件類型

    • 不支援品質和防偽檢測

    輸出證件類型和證件卡面關鍵標準化欄位，詳情參考通用識別欄位表。

    說明

    此模式下，僅支援輸出不同證件共性的欄位。

    離線輔助人審情境，識別卡面類型與關鍵字段，提升審核效率。

    返回參數

    名稱

    類型

    描述

    樣本值

    HTTP Status Code

    Integer

    HTTP狀態代碼。

    200

    HTTP Body

    RequestId

    String

    請求ID。

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

    Result.TransactionId

    String

    整個認證流程的唯一標識。

    hksb7ba1b28130d24e015d694********

    Code

    String

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

    Success

    Message

    String

    返回Code的詳細描述。

    success

    Result.Passed

    String

    是否完成識別。

    Y

    Result.SubCode

    String

    結果描述。

    200

    Result.ExtIdInfo

    String

    • OcrModel = 0：

      {
  "docType": "CHNPP01",
  "ocrIdInfo": {
    "passportNo": "E80358200",
    "expiryDate": "2026/06/05",
    "placeOfIssue": "GUANGDONG",
    "issuingAuthority": "MPS Exit & Entry Administration",
    "placeOfBirth": "HUBEI",
    "nationality": "Chinese",
    "surname": "YU",
    "givenname": "CAN",
    "countryCode": "CHN",
    "sex": "M",
    "birthDate": "1985/06/06"
  }
}

    • OcrModel = 1：

      {
  "ocrDocType":"CHN01"
}

    • OcrModel = 2：

      {
  "ocrDocType": "CHN01",
  "ocrIdInfo": {
     "given_name_s": "晶",
     "surname_s": "盧",
     "date_of_birth_s": "1976-05-23",
     "card_number_s": "642123197605230048",
     "sex_s": "F"
   }
}

    ExtIdInfo

    名稱

    類型

    描述

    樣本值

    ocrIdInfo

    String

    證件OCR欄位資訊。

    說明

    如果證件OCR流程失敗，則此欄位值為空白。

    {
  "expiryDate": "",
  "originOfIssue": "公安部出入境管理局",
  "englishName": "LI SI",
  "sex": "男",
  "name": "李四",
  "idNumber": "H11111112",
  "issueDate": "2013-01-02",
  "birthDate": "1990-02-21"
}

    spoofInfo

    String

    證件防偽檢測結果，包括風險判定結果和風險類型：

    說明

    僅當Initialize介面中 IdSpoof = Y 時，才會開啟卡證檢測。

    否則 spoofResult 預設返回N，spoofType 為空白。

    • spoofResult：

      • Y：存在風險

      • N：正常

    • spoofType：

      • SCREEN_REMARK：翻拍

      • PHOTO_COPY：複印件

      • TAMPER：PS篡改

      • SHORTCUT：截屏

    {
 "spoofResult": "Y",
 "spoofType": ["SCREEN_REMARK"]
}

    ocrDocType

    String

    證件類型編碼

    說明

    僅當OcrModel = 1 或 2時，才會返回此欄位。

    CHN01

    ocrStandardData

    String

    證件OCR標準化欄位資訊。

    說明

    僅當該證件類型支援，且OcrValueStandard設定1時返回。

    {
    "given_name_s": "HYUNEUI",
    "surname_s": "MUN",
    "date_of_expiry_s": "2028-02-08",
    "date_of_birth_s": "1988-10-26",
    "sex_s": "M"
}

    ResultObject.SubCode錯誤碼說明

    說明

    Subcode基於不同產品方案或整合方式返回，詳情可參考下表。

    適用方案

    錯誤碼

    認證記錄是否計費

    描述和原因建議

    通用

    200

    是

    認證通過。

    • ID_OCR 純服務端接入（DocOcr）

    • ID_OCR_MAX

    211

    是

    證件圖片品質或解析度不符合要求，或者圖片本身不完整。請確保證件人像面照片清晰、曝光正常，完整無遮擋，角度無太大偏差。

    • ID_OCR App（SDK）接入

    • ID_OCR Web（SDK）接入

    • ID_OCR_MAX

    212

    是

    證件防偽檢測存在風險。可能存在翻拍、篡改、複印等高風險操作。

    • ID_OCR 純服務端接入（DocOcr）

    • ID_OCR_MAX

    213

    是

    未檢測到指定對應證件類型（識別模式）或無法識別證件類型（分類模式）。

    建議傳入清晰完整且角度正常的證件圖片。