智能多媒体 API

  • OCR身份证识别

    最近更新时间:2018-11-16 17:12:06

    用户通过身份证识别接口idcard对存储在七牛云 bucket(支持华东、华北和华南 bucket)或 非七牛云 bucket 的身份证正反面图片进行智能识别,可得到身份证中姓名、性别、民族、住址和身份证号码等关键信息。目前支持的图片格式有 png、jpg 和 bmp。

    使用方式

    请求语法

    POST /v1/ocr/idcard  Http/1.1
    HOST: ai.qiniuapi.com
    Content-Type:application/json
    Authorization: Qiniu <AccessKey>:<Sign>
    
    {
        "data": {
            "uri": "http://oayjpradp.bkt.clouddn.com/age_gender_test.png"
        }
    }
    

    注意: 需要在 POST 请求的 head 部分添加七牛鉴权,以进行用户身份验证。

    请求字段说明:

    字段 取值 说明
    uri string 身份证图片链接

    响应语法

    身份正面反馈
    {
        "code": 0,
        "message": "",
        "result": {
            "uri": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQEBAQIBAQECAgICAgQD...",
            "bboxes": [
                [[134,227],[419,227],[419,262],[134,262]],
                ...
                [[115,50],[115,100],[232,100],[232,50]]
            ],
            "type": 0,
            "res": {
                "住址": "河南省xx市芙蓉巷xx胡同x号",
                "公民身份号码": "41270219970512XXXX",
                "出生": "199x年xx月xx日",
                "姓名": "张xx",
                "性别": "女",
                "民族": "汉"
            }
        }
    }
    
    身份证背面反馈
    {
        "code": 0,
        "message": "",
        "result": {
            "uri": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQEBAQIBAQECAgICAgQD...",
            "bboxes": [
                [[440,562],[440,611],[854,611],[854,562]],
                [[427,478],[427,531],[854,531],[854,478]]
            ],
            "type": 1,
            "res": {
                "有效期限","2014.05.05-2024.05.05",
                "签发机关","项城市公安局"
            }
        }
    }
    
    

    返回字段说明:

    字段 取值 说明
    code int 0:表示正确
    message string 结果描述信息
    uri string 截取原图中身份证区域后的图片 base64 编码
    bboxes list[4,2] 返回的图片中所有的文本框位置,为顺时针/逆时针方向旋转的任意四边形[[x1,y1],[x2,y2],[x3,y3],[x4,y4]]
    type int 身份证正反面标识,0:正面,1:背面
    res map[string]string 识别后信息结构化的结果
    res[姓名] string 姓名
    res[性别] string 性别
    res[民族] string 民族
    res[出生] string 出生
    res[住址] string 住址
    res[公民身份号码] string 身份证号
    res[有效期限] string 有效期限
    res[签发机关] string 签发机关

    2. 审核文件限制

    本功能对于能处理的文件有一些限制。

    图片文件的限制:

    1. 图片大小大于10M不能处理
    2. 图片尺寸大于4999x4999,小于32x32不能处理
    3. 图片纬度不等于3不能处理
    以上内容是否对您有帮助?
  • Icon free helper
    Close