文档中心

接口描述

支持对二代居民身份证正反面所有8个字段进行结构化识别，包括姓名、性别、民族、出生日期、住址、身份证号、签发机关、有效期限，识别准确率超过99%；同时支持身份证正面头像检测，并返回头像切片的base64编码及位置信息。

同时，支持对用户上传的身份证图片进行图像质量和风险检测，是否存在正反颠倒、模糊、欠曝、过曝等质量问题，可识别图片是否为复印件或临时身份证，是否被翻拍或编辑，是否存在四角不完整、头像或关键字段被遮挡。

视频教程请参见 身份证识别API调用教程（视频版）

在线调试

您可以在 示例代码中心 中调试该接口，可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。

请求说明

请求示例

HTTP 方法：POST

请求URL： https://aip.baidubce.com/rest/2.0/ocr/v1/idcard

URL参数：

Header如下：

Body中放置请求参数，参数详情如下：

请求参数

请求代码示例

提示一：使用示例代码前，请记得替换其中的示例Token、图片地址或Base64信息。

提示二：部分语言依赖的类或库，请在代码注释中查看下载地址。

curl -i -k 'https://aip.baidubce.com/rest/2.0/ocr/v1/idcard?access_token=

【调用鉴权接口获取的token】' --data 'id_card_side=front&image=【图片Base64编码，

需UrlEncode】' -H 'Content-Type:application/x-www-form-urlencoded'

返回说明

返回参数

返回示例（身份证头像面）

{ "log_id": 2648325511, "direction": 0, "image_status": "normal", "photo": 

"/9j/4AAQSkZJRgABA......", "photo_location": { "width": 1189, "top": 638, "left":

 2248, "height": 1483 }, "card_image": "/9j/4AAQSkZJRgABA......", "card_location":

 { "top": 328, "left": 275, "width": 1329, "height": 571 }, "words_result": { "住址": 

{ "location": { "left": 267, "top": 453, "width": 459, "height": 99 }, "words":

 "南京市江宁区弘景大道3889号" }, "公民身份号码": { "location": { "left": 443, "top":

 681, "width": 589, "height": 45 }, "words": "330881199904173914" }, "出生": {

 "location": { "left": 270, "top": 355, "width": 357, "height": 45 }, "words":

 "19990417" }, "姓名": { "location": { "left": 267, "top": 176, "width": 152, 

"height": 50 }, "words": "伍云龙" }, "性别": { "location": { "left": 269, "top": 262,

 "width": 33, "height": 52 }, "words": "男" }, "民族": { "location": { "left": 492, 

"top": 279, "width": 30, "height": 37 }, "words": "汉" } }, "words_result_num": 6 }

返回示例（身份证国徽面）

{ "words_result": { "失效日期": { "words": "20390711", "location": { "top": 445, 

"left": 523, "width": 153, "height": 38 } }, "签发机关": { "words": "陆丰市公安局", 

"location": { "top": 377, "left": 339, "width": 195, "height": 38 } }, "签发日期": 

{ "words": "20190606", "location": { "top": 445, "left": 343, "width": 152, "height":

 38 } } }, "log_id": "1559208562721579328", "words_result_num": 3,

 "error_code": 0, "image_status": "normal" }

AES加密

您可以选择使用AES加密来请求本身份证识别接口，支持对身份证图片及识别结果进行加密后传输，示意图如下：

1. 在百度云控制台「文字识别-应用列表-管理」中获取您的AES Key
2. 使用AES Key对将要识别的图片进行加密
3. 将加密后的图片传入接口，请求参数AESEncry设置为true
4. 接口返回加密后的识别结果，使用AES Key进行解密，得到明文识别结果
   

使用AES加密不影响身份证识别接口支持的质量检测、风险检测等其他能力，也不影响识别效果。

请求说明

请求示例

HTTP 方法：POST

请求URL： https://aip.baidubce.com/rest/2.0/ocr/v1/idcard

URL参数：

Header如下：

Body中放置请求参数，参数详情如下：

请求参数

请求代码示例

提示一：使用示例代码前，请记得替换其中的示例Token、图片地址或Base64信息。

提示二：部分语言依赖的类或库，请在代码注释中查看下载地址。

• Python
• JAVA
• C++
• PHP
• C#

# -*- coding: utf-8 -*- # from urllib import urlencode import base64 from urllib import 

unquote import requests import json from Crypto.Cipher import AES import binascii

ak = "ak" # 文字识别应用的API Key sk = "sk" # 文字识别应用的Secret Key aes = 'res'

 # aes key 从控制台 文字识别-应用列表-应用管理 获取 class AESCipher: def __init__

(self, key): self.key = self.get_key(key) def get_key(self, key): st = bytearray() 

for s in key: st.append(int(s, 16)) str = st.decode('utf-8') return str def pad(self,

 text): # 填充方法，加密内容必须为16字节的倍数 text_length = len(text) amount_to_pad =

 AES.block_size - (text_length % AES.block_size) if amount_to_pad == 0: amount_to_pad = AES.block_size
        pad = chr(amount_to_pad) return text + pad * amount_to_pad def __unpad(self, text): 

# 截取填充的字符 pad = ord(text[-1]) return text[:-pad] # 加密函数 def encrypt(self, raw): 

raw = self.pad(raw) cipher = AES.new(self.key, AES.MODE_ECB) return base64.b64encode

(cipher.encrypt(raw)) def decrypt(self, enc): """
        解密方法
        :param enc: base64编码的密文 str
        :return: 解密后的明文 str
        """ cipher = AES.new(self.key, AES.MODE_ECB) return self.__unpad(cipher.decrypt(enc))

 def get_accessToken(): url = "https://aip.baidubce.com/oauth/2.0/token?grant_type=client

_credentials&client_id={ak}&client_secret={sk}".format( ak=ak, sk=sk) response = requests.

get(url) return response.json()['access_token'] encryptor = AESCipher(aes) token = 

get_accessToken() # 改成接口文档里的url nameurl = "https://aip.baidubce.com/rest/2.0/

ocr/v1/idcard" url = nameurl + "?access_token={token}".format(token=token) print url

f = open('resources/my.jpg', 'rb') d = f.read() r_data = encryptor.encrypt(d) 

# 构造请求数据格式 data = {} data['image'] = r_data
data['id_card_side'] = 'front' data['AESEncry'] = 'true' headers = {'content-type':

 'application/x-www-form-urlencoded'} res = requests.post(url=url, data=data, 

headers=headers) #res= json.dumps(res.content, ensure_ascii=False) data=json.loads

(res.content) result=encryptor.decrypt(base64.b64decode(data['result'])) print result

返回说明

返回示例

{ "log_id":"2648325511", "result":"密文" }

请对result密文进行base64解码后得到byte流，再进行AES解密，得到识别结果的明文。