全部产品
Search

搜索本产品

    ID Verification：ID_OCR_MAX

    文档中心

    ID Verification：ID_OCR_MAX

    更新时间：Sep 16, 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.cn-hongkong.aliyuncs.com

      • 内网：cloudauth-intl-vpc.cn-hongkong.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：证件自动分类+通用识别模式

    • 3：国家 / 地区编码的证件自动分类+指定证件识别模式

    0

    DocType

    String

    否

    【OCR配置】证件编码，或国家 / 地区编码。若传入国家/地区编码，最多可指定3个（例如：CHN,HKG,GLB）作为自动分类范围。系统将自动检索该范围内支持的证件类型，并在识别成功后返回具体的证件编码。

    请在证件编码表中查询支持的国家/地区证件编码；在证件OCR字段表中查询每种证件的OCR返回字段详情。

    重要

    受地域模型限制，不同地域支持识别的证件类型不一致。

    • 新加坡/中国香港地域：支持识别证件编码表中的证件。

    • 印度尼西亚地域：仅支持识别印度尼西亚身份证和全球护照（证件编码IDN01001和GLB03002）。

    • 马来西亚地域：仅支持识别马来西亚身份证和全球护照（证件编码MYS01001和GLB03002）

    • OcrModel = 0：DocType必传，指定证件类型。

    • OcrModel = 1或2：DocType不生效。

    • OcrModel = 3：DocType必传，指定需要分类的国家 / 地区编码。

    GLB03001

    DocPage

    String

    否

    期望识别的页面

    • 01（默认）：证件人像面

    • 02：证件背面

    重要

    若模型检测与指定识别页面不符，将返回Subcode：213。

    01

    IdSpoof

    String

    否

    是否开启证件防伪功能：

    • T（默认）：开启

    • F：不开启

    F

    IdThreshold

    String

    否

    【OCR配置】是否开启卡证质量检测：

    • 1：开启严格模式

    • 2：开启宽松模式（默认）

    • 3：关闭

    3

    OcrValueStandard

    String

    否

    是否需要额外返回OCR识别标准化格式字段：

    • 0：否 （默认）

    • 1：是

    说明

    支持的证件类型、标准化字段，详情请参见：字段标准化功能说明。

    0

    不同识别模式差异说明

    OCR识别模式

    输入差异

    输出差异

    建议适用场景

    0：指定证件识别模式

    • 需要输入指定证件类型和页面。

      当前支持的识别证件类型和页面参考：证件编码表

    • 可选开启质量和防伪检测

    输出证件详细字段，详情参考：证件OCR字段表

    在线准入场景，自动化校验证件类型是否业务允许，并输出卡面详细字段。

    1：证件自动分类模式

    重要

    仅新加坡地域支持该识别模式。

    • 无需指定证件类型

    • 可开启质量检测

    • 不支持防伪检测

    仅输出检测的证件类型编码（例如CHN01），详情参考：全球卡证编码。

    离线业务分析场景，用于历史卡证图片聚类清洗。

    2：证件自动分类并通用识别模式

    重要

    仅新加坡地域支持该识别模式。

    • 无需指定证件类型

    • 可开启质量检测

    • 不支持防伪检测

    输出证件类型编码和（例如CHN01）证件卡面关键共性字段，详情参考通用识别字段表。

    说明

    此模式下，仅支持输出不同证件共性的字段。

    离线辅助人审场景，识别卡面类型与关键字段，提升审核效率。

    3：国家 / 地区编码的证件自动分类+指定证件识别模式

    • 需指定国家/区域编码

    • 可选开启质量和防伪检测

    输出证件编码（例如CHN01001）和证件详细字段，详情参考：证件OCR字段表。

    在线准入场景，指定国家/区域的多证件是否业务允许，并输出对应卡面详细字段。

    返回参数

    名称

    类型

    描述

    示例值

    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

    Result.SubCode错误码说明。

    200

    Result.ExtIdInfo

    String

    证件 OCR 与防伪结果。具体信息，请参见ExtIdInfo。

    • OcrModel = 0：

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

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

    • OcrModel = 3：

      {
  "ocrDocType": "CHN01001",
  "ocrIdInfo": {
  "expiryDate": "",
  "originOfIssue": "公安部出入境管理局",
  "englishName": "LI SI",
  "sex": "男",
  "name": "李四",
  "idNumber": "H11111112",
  "issueDate": "2013-01-02",
  "birthDate": "1990-02-21"
},
  "spoofInfo":{
     "spoofResult": "Y",
     "spoofType": ["SCREEN_REMARK"]
  },
}

    ExtIdInfo

    名称

    类型

    描述

    示例值

    ocrDocType

    String

    证件类型编码或证件编码

    说明

    • 当OcrModel = 1 或 2时，返回5位证件类型编码（例如CHN01）。

    • 当OcrModel = 3时，返回详细证件编码（例如CHN01001）。

    CHN01

    ocrIdInfo

    String

    证件OCR字段信息。

    说明

    • 若证件OCR流程失败，则此字段值为空。

    • 若OcrModel = 1，则此字段值为空。

    • 若OcrModel = 2，则此字段值为自动分类证件的共性字段。

    • 若OcrModel = 3，则此字段值为证件页面字段。

    • OcrModel = 2

       {
     "given_name_s": "晶",
     "surname_s": "卢",
     "date_of_birth_s": "1976-05-23",
     "card_number_s": "642123197605230048",
     "sex_s": "F"
   }

    • OcrModel = 1/3

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

    spoofInfo

    String

    证件防伪检测结果，包括风险判定结果和风险类型：

    说明

    仅当入参中 IdSpoof = T时，才会开启卡证检测。

    否则 spoofResult 返回N，spoofType 为空。

    • spoofResult：

      • Y：存在风险

      • N：正常

    • spoofType：

      • SCREEN_REMARK：翻拍

      • PHOTO_COPY：复印件

      • TAMPER：PS篡改

      • SHORTCUT：截屏

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

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

    Result.SubCode错误码说明

    错误码

    认证记录是否计费

    描述和原因建议

    200

    是

    认证通过。

    211

    是

    【证件方案】证件图片质量或分辨率不符合要求，或者图片本身不完整。请确保证件人像面照片清晰、曝光正常，完整无遮挡，角度无太大偏差。

    212

    是

    【证件方案】证件防伪检测存在风险。可能存在翻拍、篡改、复印等高风险操作。

    213

    是

    【证件方案】未检测到指定对应证件类型（识别模式）或无法识别证件类型（分类模式）。

    建议传入清晰完整且角度正常的证件图片。