文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>对象存储>SDK 文档>Python SDK>内容识别>人脸核身>身份证识别

身份证识别

最近更新时间：2025-06-17 20:13:52

我的收藏

本页目录：

简介

本文档提供关于身份证识别的相关 API 概览以及 SDK 示例代码。
API
操作描述
身份证识别

功能说明

支持中国大陆居民二代身份证正反面所有字段的识别，包括姓名、性别、民族、出生日期、住址、公民身份证号、签发机关、有效期限；具备身份证照片、人像照片的裁剪功能和翻拍、PS、复印件告警功能，以及边框和框内遮挡告警、临时身份证告警和身份证有效期不合法告警等扩展功能。

示例代码

from qcloud_cos import AIRecognitionClient
from qcloud_cos import CosConfig

# 替换为用户的 SecretId，请登录访问管理控制台进行查看和管理，https://console.cloud.tencent.com/cam/capi
secret_id = os.environ["SECRETID"]
# 替换为用户的 SecretKey，请登录访问管理控制台进行查看和管理，https://console.cloud.tencent.com/cam/capi
secret_key = os.environ["SECRETKEY"]
# 替换为用户的 region，已创建桶归属的 region 可以在控制台查看，https://console.cloud.tencent.com/cos5/bucket
region = 'ap-chongqing'
# COS 支持的所有 region 列表参见 https://cloud.tencent.com/document/product/436/6224
# 如果使用永久密钥不需要填入 token，如果使用临时密钥需要填入，临时密钥生成和使用指引参见 https://cloud.tencent.com/document/product/436/14048
token = None
config = CosConfig(Region=region, SecretId=secret_id, SecretKey=secret_key, Token=token)
client = AIRecognitionClient(config)
bucket_name = 'test-1250000000'

def cos_ai_id_card_ocr():
    # 身份证识别
    response, data = client.cos_ai_id_card_ocr(
        Bucket=bucket_name,
        ObjectKey="test.jpeg",
        # CardSide="FRONT",
        Config='{"CropIdCard":true,"CropPortrait":true}'
    )
    print(response)
    print(data)
    return response, data

参数说明

调用 cos_aiid_card_ocr 函数，具体请求参数如下：
参数名称
参数描述
类型
是否必填
Bucket
存储桶名称
String
是
ObjectKey
设置对象名称
String
是
CardSide
FRONT：身份证有照片的一面（人像面）
BACK：身份证有国徽的一面（国徽面）
该参数如果不填，将为您自动判断身份证正反面
String
否
Config
以下可选字段均为 bool 类型，默认 false：
CropIdCard，身份证照片裁剪（去掉证件外多余的边缘、自动矫正拍摄角度）
CropPortrait，人像照片裁剪（自动抠取身份证头像区域）
CopyWarn，复印件告警
BorderCheckWarn，边框和框内遮挡告警
ReshootWarn，翻拍告警
DetectPsWarn，PS 检测告警
TempIdWarn，临时身份证告警
InvalidDateWarn，身份证有效日期不合法告警
Quality，图片质量分数（评价图片的模糊程度）
MultiCardDetect，是否开启多卡证检测
参数设置方式参考：Config = {"CropIdCard":true,"CropPortrait":true}
String
否

返回结果说明

response 为响应头，data 为身份证识别结果，数据类型都为 dict。

response 内容

返回公共响应头部，详情请参见 公共响应头部 文档。

响应体 data

响应体具体数据内容如下：
参数名称
参数描述
类型
IdInfo
身份证识别信息
Container
AdvancedInfo
扩展信息，不请求则不返回
Container
AdvancedInfo 节点内容：
参数名称
参数描述
类型
IdCard
裁剪后身份证照片的 Base64编码，设置 Config.CropIdCard 为 true 时返回
String
Portrait
身份证头像照片的 Base64编码，设置 Config.CropPortrait 为 true 时返回
String
Quality
图片质量分数，设置 Config.Quality 为 true 时返回（取值范围：0~100，分数越低越模糊，建议阈值≥50）
String
BorderCodeValue
身份证边框不完整告警阈值分数，设置 Config.BorderCheckWarn 为 true 时返回（取值范围：0~100，分数越低边框遮挡可能性越低，建议阈值≥50）
String
WarnInfos
告警信息，仅当存在异常时返回，Code 告警码列表和释义：
9100身份证有效日期不合法告警
9101身份证边框不完整告警
9102身份证复印件告警
9103身份证翻拍告警
9104临时身份证告警
9105身份证框内遮挡告警
9106身份证 PS 告警
可能存在多个 WarnInfos
String
IdInfo 节点内容：
参数名称
参数描述
类型
Name
姓名（人像面）
String
Sex
性别（人像面）
String
Nation
民族（人像面）
String
Birth
出生日期（人像面）
String
Address
地址（人像面）
String
IdNum
身份证号（人像面）
String
Authority
发证机关（国徽面）
String
ValidDate
证件有效期（国徽面）
String
中国站
目录