全部产品
Search

搜索本产品

    ID Verification：ID_OCR_MAX

    文档中心

    ID Verification：ID_OCR_MAX

    更新时间：Feb 10, 2026

    ID_OCR_MAX 是 ID Verification 基于Qwen-VL大模型推出的卡证识别方案，支持全球多种身份证件类型检测与识别。

    重要

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

    • 新加坡地域：支持识别证件类型表中的证件。

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

    • 马来西亚地域：仅支持识别马来西亚身份证和全球护照（证件类型编码MYS01001和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

      马来西亚（吉隆坡）

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

      • 内网：cloudauth-intl-vpc.ap-southeast-3.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：严格模式

    • 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：证件自动分类并通用识别模式

    重要

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

    • 无需指定证件类型

    • 不支持质量和防伪检测

    输出证件类型和证件卡面关键标准化字段，详情参考通用识别字段表。

    说明

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

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

    字段标准化功能说明

    针对全球证件多样性，ID Verification 新增字段标准化功能，支持对如下证件关键字段进行标准化格式输出。

    支持的证件类型

    说明

    • 当前仅支持如下证件，其他证件类型会基于需求逐步开放返回。

    • 由于姓名规则复杂，拉丁文姓名的标准化输出可能存在不准确的情况，建议提醒终端用户进行二次确认。

    中国

    中华人民共和国居民身份证

    CHN01001

    01、02

    中国台湾

    台湾身份证

    TWN01001

    01

    韩国

    韩国身份证

    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

    是

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

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