智能多媒体服务 >
API 文档 >
票证自动识别（OCR） >
驾驶证 OCR
驾驶证 OCR
最近更新时间: 2026-08-18 15:21:04
接口说明
驾驶证识别支持对驾驶证上所有字段的自动定位与识别。
限制条件
- 文件格式：支持JPG、JPEG、PNG、BMP、PDF等常见格式，建议使用JPG格式。
- 图片像素尺寸：为了保证文字识别效果，推荐图片中驾驶证最短边长不低于256像素。
- 输入文件大小：要求Base64编码和urlencode之后不超过 8 MB。驾驶证主体尽量占据图片主要区域。
- 输入文件过大时，返回的HttpCode如下：400/413/502。
- 注意图片质量：保证驾驶证图片足够清晰，不应该有因为压缩导致的噪声，避免对驾驶证正反面的遮挡、不当的光照（强光、暗光、逆光）等，否则会降低结果准确度。
- 图片需要有版权，有肖像权，没有法律或者政策风险的。相关风险请注意评估。
- 驾驶证图片不可以是复印件、翻拍件、PS件等。
- 输入多页PDF时，默认只识别第一页。
请求
请求地址
| 名称 | 值 |
|---|
| HTTP URL | https://ap-gate-z0.qiniuapi.com/ocr/driving/license |
| HTTP Method | POST |
请求头
| 名称 | 必填 | 说明 |
|---|
| Host | 是 | 固定值ap-gate-z0.qiniuapi.com |
| Authorization | 是 | 该参数应严格按照管理凭证格式进行填充，否则会返回 401 错误码。一个合法的 Authorization 值应类似于：Qiniu QNJi_bYJlmO5LeY08FfoNj9w_r7... |
| Content-Type | 是 | 固定值application/json |
请求参数
| 字段 | 必填 | 类型 | 说明 |
|---|
| image_base64 | 否 | string | 驾驶证图片文件，base64编码 |
| image_url | 否 | string | 图片/PDF文件的URL链接
注意: 要求image_base64与image_url二选一，如果2个字段都有，优先解析image_base64。 |
请求示例
POST /ocr/driving/license
Host: ap-gate-z0.qiniuapi.com
Authorization: <no value>
Content-Type: application/json
{
"image_base64": "base64"
}
响应
响应头
| 名称 | 必填 | 说明 |
|---|
| Content-Type | 是 | 固定值application/json |
响应参数
| 字段 | 必填 | 类型 | 说明 |
|---|
| message | 是 | string | 错误信息 |
| request_id | 是 | string | 请求唯一ID |
| time_elapsed | 是 | string | 请求耗时 |
| code | 是 | number | 错误码 |
| data | 否 | object data | |
其中，data 参数
| 字段 | 必填 | 类型 | 说明 |
|---|
| license_main | 否 | object license_main | |
其中，license_main 参数
| 字段 | 必填 | 类型 | 说明 |
|---|
| id_photo_location | 否 | []object id_photo_location | 相片位置 |
| valid_begin | 否 | string | 有效期起 |
| valid_end | 否 | string | 有效期止 |
| class | 否 | string | 准驾车型 |
| date_of_birth | 否 | string | 出生日期 |
| date_of_first_issue | 否 | string | 初次领证日期 |
| nationality | 否 | string | 国籍 |
| id_number | 否 | string | 证号 |
| record | 否 | string | 记录 |
| sex | 否 | string | 性别 |
| address | 否 | string | 住址 |
| document_id | 否 | string | 档案编号 |
| licence_issuing_authority | 否 | string | 发证机关 |
| name | 否 | string | 姓名 |
其中，id_photo_location 参数
| 字段 | 必填 | 类型 | 说明 |
|---|
| x0 | 否 | number | |
| x1 | 否 | number | |
| x3 | 否 | number | |
| y0 | 否 | number | |
| y2 | 否 | number | |
| y4 | 否 | number | |
| x2 | 否 | number | |
| x4 | 否 | number | |
| y1 | 否 | number | |
| y3 | 否 | number | |
响应示例
200 OK
Content-Type: application/json
{
"code": 10000,
"data": {
"license_main": {
"address": "山东省XX市XX镇XX村XX",
"class": "C1",
"date_of_birth": "1900-01-01",
"date_of_first_issue": "2016-01-01",
"id_number": "370XXX19000101XXXX",
"name": "张三",
"nationality": "中国",
"sex": "女",
"valid_begin": "2016-01-01",
"valid_end": "2022-01-01"
}
},
"message": "Success",
"request_id": "6838889517957515275",
"time_elapsed": "41.897331ms"
}