tencent cloud

对象存储

动态与公告
产品动态
产品公告
产品简介
产品概述
功能概览
应用场景
产品优势
基本概念
地域和访问域名
规格与限制
产品计费
计费概述
计费方式
计费项
免费额度
计费示例
查看和下载账单
欠费说明
常见问题
快速入门
控制台快速入门
COSBrowser 快速入门
用户指南
创建请求
存储桶
对象
数据管理
批量处理
全球加速
监控与告警
运维中心
数据处理
内容审核
智能工具箱
数据工作流
应用集成
工具指南
工具概览
环境安装与配置
COSBrowser 工具
COSCLI 工具
COSCMD 工具
COS Migration 工具
FTP Server 工具
Hadoop 工具
COSDistCp 工具
HDFS TO COS 工具
GooseFS-Lite 工具
在线辅助工具
自助诊断工具
实践教程
概览
访问控制与权限管理
性能优化
使用 AWS S3 SDK 访问 COS
数据容灾备份
域名管理实践
图片处理实践
COS 音视频播放器实践
工作流实践
数据直传
内容审核实践
数据安全
数据校验
大数据实践
COS 成本优化解决方案
在第三方应用中使用 COS
迁移指南
本地数据迁移至 COS
第三方云存储数据迁移至 COS
以 URL 作为源地址的数据迁移至 COS
COS 之间数据迁移
Hadoop 文件系统与 COS 之间的数据迁移
数据湖存储
云原生数据湖
元数据加速
数据加速器 GooseFS
数据处理
数据处理概述
图片处理
媒体处理
内容审核
文件处理
文档处理
故障处理
获取 RequestId 操作指引
通过外网上传文件至 COS 缓慢
访问 COS 时返回403错误码
资源访问异常
POST Object 常见异常
API 文档
简介
公共请求头部
公共响应头部
错误码
请求签名
操作列表
Service 接口
Bucket 接口
Object 接口
批量处理接口
数据处理接口
任务与工作流
内容审核接口
云查毒接口
SDK 文档
SDK 概览
准备工作
Android SDK
C SDK
C++ SDK
.NET(C#) SDK
Flutter SDK
Go SDK
iOS SDK
Java SDK
JavaScript SDK
Node.js SDK
PHP SDK
Python SDK
React Native SDK
小程序 SDK
错误码
鸿蒙(Harmony) SDK
终端 SDK 质量优化
安全与合规
数据容灾
数据安全
访问管理
常见问题
热门问题
一般性问题
计费计量问题
域名合规问题
存储桶配置问题
域名和 CDN 问题
文件操作问题
日志监控问题
权限管理问题
数据处理问题
数据安全问题
预签名 URL 问题
SDK 类问题
工具类问题
API 类问题
服务协议
Service Level Agreement
隐私政策
数据处理和安全协议
联系我们
词汇表
文档对象存储API 文档数据处理接口AI 内容识别卡证识别身份证识别

身份证识别

PDF
聚焦模式
字号
最后更新时间： 2026-01-09 18:31:33

功能描述

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

授权说明

通过子账号使用时，需要在 授权策略 的 action 中授予 ci:CreateIDCardOCRJob 权限，数据万象支持的所有操作接口请参见 action。

服务开通

使用该功能需提前 绑定存储桶，开通数据万象服务。
注意：
数据万象绑定后，如果您手动对存储桶进行数据万象的解绑操作，将无法继续使用该功能。

使用限制

使用该接口时，请先确认相关限制条件。详情请参见 使用限制。

费用说明

该接口为付费服务，产生的费用将由数据万象收取，详细计费说明可参见 内容识别费用。


请求

请求示例

该请求能够对已存储在 COS 的身份证图片进行相应处理操作，返回识别结果。
GET /<ObjectKey>?ci-process=IDCardOCR&CardSide=<CardSide>&Config=<Config> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
说明：
Authorization: Auth String，详情请参见 请求签名 文档。

请求头

此接口仅使用公共请求头部，详情请参见 公共请求头部 文档。

请求参数

参数名称
描述
类型
是否必选
ObjectKey
对象文件名，例如：folder/document.jpg
String
是
ci-process
数据万象处理能力，身份证识别固定为 IDCardOCR
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
否

请求体

该请求无请求体。

响应

响应头

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

响应体

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

实际案例

请求

GET /test.jpg?ci-process=IDCardOCR&CardSide=FRONT&Config={"CropIdCard"：true, "CropIdCard"：true} HTTP/1.1
Authorization: q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=****************************************
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com

响应

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 414641
Date: Thu, 15 Jun 2017 12:37:29 GMT
Server: tencent-ci
x-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****

<Response>
  <IdInfo>
     <Name>李明</Name>
     <Sex>男</Sex>
     <Nation>汉</Nation>
     <Birth>1987/1/1</Birth>
     <Address>北京市石景山区高新技术园腾讯大楼</Address>
     <IdNum>440524198701010014</IdNum>
  </IdInfo>
  <AdvancedInfo>
     <IdCard>裁剪后身份证照片的 Base64 编码</IdCard>
     <Portrait>身份证头像照片的 Base64 编码</Portrait>
  </AdvancedInfo>
</Response>

错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误信息请参见 错误码 文档。
错误码
描述
FailedOperation.DownLoadError
文件下载失败
FailedOperation.EmptyImageError
图片内容为空
FailedOperation.IdCardInfoIllegal
身份证信息不合法（身份证号、姓名字段校验非法等）
FailedOperation.ImageBlur
图片模糊
FailedOperation.ImageDecodeFailed
图片解码失败
FailedOperation.ImageNoIdCard
图片中未检测到身份证
FailedOperation.ImageSizeTooLarge
图片尺寸过大，请参考输出参数中关于图片大小限制的说明
FailedOperation.MultiCardError
照片中存在多张卡
FailedOperation.OcrFailed
OCR 识别失败
FailedOperation.UnKnowError
未知错误
FailedOperation.UnOpenError
服务未开通
InvalidParameter.ConfigFormatError
Config 格式错误
InvalidParameterValue.InvalidParameterValueLimit
参数值错误
LimitExceeded.TooLargeFileError
文件内容太大
ResourcesSoldOut.ChargeStatusException
计费状态异常
上一篇: 更新模板下一篇: 同步任务

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈