身份证识别 OCR

HTTPS
支持二代身份证正反面所有字段的识别,包括姓名、性别、民族、出生日期、住址、公民身份证号、签发机关、有效期限,并返回结构化的文字结果,提供方便快捷的身份证信息录入体验。
免费套餐
套餐 1
套餐 2
套餐 3
套餐 4
0 / 50 次

雷达评级

AA

用户规模

10 万+

产品上线

5

身份证识别 OCR

接口地址
https://tupu.apistd.com/v3/recognition/idcard-orc
请求格式
multipart/form-data
响应格式
application/json
请求方法
POST
请求参数 (Query)
参数类型必须描述
keystring
string
请求 AccessKey, 请在控制台中查看
请求参数 (Body)
参数类型必须描述
imagefile
string|file
1、支持传图片URL或者直接post图片文件,不过两者不能混在同一请求中;2、支持多个image参数,也就是上传多个图片文件;3、只支持对静态图像的处理,如:png、jpg、jpeg、tif、webp,不支持动态图像的处理,如:gif;如需识别请参考视频识别;4、为了加快网络传输速度,图片大小必须在1M以内,且建议对图片进行压缩处理,等比压缩到[256, 512]之间。
tagstring
string
用于给图片或文本附加额外信息(比如:直播客户可能传房间号,或者主播ID信息)。方便后续根据tag搜索到相关的图片或文本。1、支持多个tag参数,和image或text参数一一对应;2、如果tag只有一个,或者tag数量少于image或text,缺省用最后一个tag补全(尾补全)。
refererstring
string
根据图片url下载图片时,将其赋值给HTTP Header的Referer,用于图片防盗链
返回参数 (Body)
参数类型描述
codenumber
number
请求的状态码
messagestring
string
请求的状态信息
timestampnumber
number
当前的服务器的Unix时间戳
noncenumber
number
随机数
dataobject
object
识别任务的结果
fileListarray
array
每张图片的识别结果
namestring
string
如果上传的image参数是url,则该值是图片url;如果是以图片文件上传,则该值为文件名
objectsarray
array
检测出来的所有物体
locationarray
array
物体方框坐标[左上角坐标,右上角坐标,右下角坐标,左下角坐标]
categorynumber
number
身份证信息类别 0 姓名 1 性别 2 民族 3 出生日期 4 住址 5 公民身份号码 6 签发机关 7 有效期限
scoresnumber
number
身份证信息类别分数,准确度[0~1],分数越高,该类型越准确
请求返回示例
{
  "data": {
    "fileList": [
      {
        "name": "69.jpg",
        "objects": [
          {
            "location": [
              [
                0.1666584814434119,
                0.49657039130146347
              ],
              [
                0.5879490625019006,
                0.49657039130146347
              ],
              [
                0.5879490625019006,
                0.5524071807059837
              ],
              [
                0.1666584814434119,
                0.5524071807059837
              ]
            ],
            "category": 4,
            "scores": 1,
            "text": "福建省南安市官桥镇黄山村340号",
            "degree": 359.73989787958794
          },
          {
            "location": [
              [
                0.17333333333333334,
                0.36625
              ],
              [
                0.3622222222222222,
                0.36625
              ],
              [
                0.3622222222222222,
                0.4
              ],
              [
                0.17333333333333334,
                0.4
              ]
            ],
            "category": 0,
            "scores": 1,
            "text": "郭佳",
            "degree": 359
          },
          {
            "location": [
              [
                0.29777777777777775,
                0.60375
              ],
              [
                0.8933333333333333,
                0.60375
              ],
              [
                0.8933333333333333,
                0.6325
              ],
              [
                0.29777777777777775,
                0.6325
              ]
            ],
            "category": 5,
            "scores": 1,
            "text": "3203583200001291234",
            "degree": 360
          },
          {
            "location": [
              [
                0.1711111111111111,
                0.4125
              ],
              [
                0.2511111111111111,
                0.4125
              ],
              [
                0.2511111111111111,
                0.44125
              ],
              [
                0.1711111111111111,
                0.44125
              ]
            ],
            "category": 1,
            "scores": 1,
            "text": "男",
            "degree": 359
          },
          {
            "location": [
              [
                0.3688888888888889,
                0.4125
              ],
              [
                0.45555555555555555,
                0.4125
              ],
              [
                0.45555555555555555,
                0.44125
              ],
              [
                0.3688888888888889,
                0.44125
              ]
            ],
            "category": 2,
            "scores": 1,
            "text": "汉",
            "degree": 359
          },
          {
            "location": [
              [
                0.17157480259879954,
                0.45590068773964343
              ],
              [
                0.46529265356968585,
                0.45590068773964343
              ],
              [
                0.46529265356968585,
                0.4800918657957196
              ],
              [
                0.17157480259879954,
                0.4800918657957196
              ]
            ],
            "category": 3,
            "scores": 1,
            "text": "2000-1-29",
            "degree": 359.35617157790796
          }
        ]
      }
    ]
  },
  "code": 0,
  "message": "success",
  "nonce": "0.740538157274206",
  "timestamp": 1574246346767
}

身份证识别 OCR-API接口介绍