全部產品
Search

搜尋本產品

    ID Verification：ID_OCR_MAX

    文件中心

    ID Verification：ID_OCR_MAX

    更新時間：Dec 25, 2025

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

    重要

    該介面在印尼地區僅支援印尼身份證和全球護照（證件類型編碼IDN01001和GLB03002）的識別。

    服務地址

    • 介面名：DocOcrMax

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

    • 要求方法： 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

      印尼

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

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

    線上調試和整合

    說明

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

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

    傳入圖片格式要求

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

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

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

      說明

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

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

    • 圖片品質建議：

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

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

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

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

    請求參數

    照片傳入提供兩種方式，任選其一即可。

    • IdOcrPictureBase64

    • IdOcrPictureUrl

    名稱

    類型

    是否必選

    描述

    樣本值

    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

    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品質檢測閾值模式：

    • 0：系統預設

    • 1：strict 模式

    • 2：寬鬆模式

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

    3

    OcrValueStandard

    String

    否

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

    • 0：否 (預設)

    • 1：是

    說明

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

    0

    Authorize

    String

    否

    是否啟用權威資料來源核驗以增強證件防偽能力。

    • T：啟用

    • F：不啟用（預設值）

    說明

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

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

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

    T

    不同識別模式差異說明

    OCR識別模式

    輸入差異

    輸出差異

    建議適用情境

    0：指定證件識別模式

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

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

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

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

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

    1：證件自動分類模式

    重要

    印尼Reigon不支援該識別模式。

    • 無需指定證件類型

    • 不支援品質和防偽檢測

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

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

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

    重要

    印尼Reigon不支援該識別模式。

    • 無需指定證件類型

    • 不支援品質和防偽檢測

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

    說明

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

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

    欄位標準化功能說明

    針對全球證件多樣性，ID Verification 新增欄位標準化功能，支援對如下證件關鍵字段進行標準化格式輸出

    支援的證件類型

    說明

    當前僅支援韓國的如下3種證件，其他證件類型會基於需求逐步開放返回。

    韓國

    韓國身份證

    KOR01001

    01

    韓國駕照

    KOR02001

    01

    韓國護照

    KOR03001

    01

    支援標準化的欄位

    欄位

    類型

    描述

    surname_s

    String

    拉丁字母的姓。

    given_name_s

    String

    拉丁字母的名。

    sex_s

    String

    性別，F或M。

    date_of_birth_s

    String

    出生日期， yyyy-mm-dd 格式。

    date_of_expiry_s

    String

    證件到期日期， yyyy-mm-dd 格式。

    返回參數

    名稱

    類型

    描述

    樣本值

    HTTP Status Code

    Integer

    HTTP狀態代碼。

    200

    HTTP Body

    RequestId

    String

    請求ID。

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

    Result.TransactionId

    String

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

    hksb7ba1b28130d24e015d694********

    Code

    String

    返回碼。

    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篡改

    {
 "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"
}

    返回Code

    HTTP狀態代碼

    Code

    Message說明

    200

    Success

    請求成功。

    400

    MissingParameter

    參數不可為空。

    InvalidParameter

    非法參數。

    401

    UnqualifiedPhoto

    傳入的圖片不可讀，或圖片解析度不符合要求，建議更換圖片。

    需確保照片清晰、曝光正常，完整無遮擋，角度無太大偏差。

    DataDuplication

    同時傳入Base64編碼的圖片和Url圖片地址，此二參數任選其一即可。

    ToolargeImage

    圖片尺寸過大，建議壓縮圖片或更換圖片上傳方式。

    DownloadTimeout

    URL圖片下載逾時。

    403

    Forbidden.RAMUserAccessDenied

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

    Forbidden.AccountAccessDenied

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

    Throttling.Api

    API限流攔截。

    500

    InternalError

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

    503

    ServiceUnavailable

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

    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

    是

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

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