行驶证识别支持对行驶证上所有字段的自动定位与识别。
| 名称 | 内容 |
|---|---|
| 输入要求 | 1. 文件格式：支持JPG、JPEG、PNG、BMP、PDF等常见格式，建议使用JPG格式。 2. 图片像素尺寸：最小 256 x 256 像素，最大 2048 x 2048 像素。为了保证文字识别效果，推荐图片中行驶证最短边长不低于256像素。 3. 文件大小： a.要求Base64编码和urlencode之后不超过 8 MB。行驶证主体尽量占据图片主要区域，不支持黑白图片。 b.如果传图片及PDF完整URL，URL对应文件大小建议不要超过8MB。 4. 输入文件过大时，返回的HttpCode如下：400/413/502。 5. 注意图片质量：保证行驶证图片足够清晰，不应该有因为压缩导致的噪声，避免对行驶证正反面的遮挡、不当的光照（强光、暗光、逆光）等，否则会降低结果准确度。 6. 图片需要有版权，有肖像权，没有法律或者政策风险的。相关风险请注意评估。 。 7. 输入多页PDF时，默认只识别第一页。 |
| 名称 | 内容 |
|---|---|
| 接口地址 | https://visual.volcengineapi.com |
| 请求方式 | POST |
| Content-Type | application/x-www-form-urlencoded (传入参数不包含类型File) multipart/form-data (参数包含类型File) |
| 是否需要鉴权 | 是 |
以下请求参数列表仅列出了接口请求参数和必要公共参数，完整公共参数列表见 公共参数。
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| X-Date | String | 是 | 使用UTC时间，精确到秒。请使用格式：YYYYMMDD'T'HHMMSS'Z' ，例如：20201103T104027Z |
Authorization | String | 是 | HMAC-SHA256：签名方法 |
| X-Security-Token | String | 否 | 指安全令牌服务（Security Token Service，STS） 颁发的临时安全凭证中的SessionToken，使用长期密钥时无需填写该参数。 |
| 参数 | 可选/必选 | 类型 | 说明 |
|---|---|---|---|
| Action | 必选 | String | 接口名，取值：VehicleLicense |
| Version | 必选 | String | 版本号，取值：2020-08-26 |
| 参数 | 可选/必选 | 类型 | 说明 |
|---|---|---|---|
| image_base64 | 与image_url二选一 | String | 行驶证图片文件，base64编码 注意: 只需要传图片的base64值，类似data:image/png;base64的图片头不要传入 |
| image_url | 与image_base64二选一 | String | 图片/PDF文件的URL链接 注意: 要求image_base64与image_url二选一，如果2个字段都有，优先解析image_base64。 |
请参考通用返回字段及错误码 |
| 字段 | 类型 | 说明 | 备注 |
|---|---|---|---|
| license_main | main_info | 主页面信息 | 字段说明见下方 |
| 字段 | 类型 | 说明 | 备注 |
|---|---|---|---|
| plate_number | String | 号牌号码 | 行驶证正、副页均有"号牌号码"字段，如果图片中同时存在正副页，则输出结果优先以正页结果为准（即图片中不存在正页号牌号码时，才会输出副页结果） |
| vehicle_type | String | 车辆类型 | 主页信息 |
| owner | String | 所有人 | 主页信息 |
| address | String | 住址 | 主页信息 |
| use_character | String | 使用性质 | 主页信息 |
| model | String | 品牌型号 | 主页信息 |
| vin | String | 车辆识别代号 | 主页信息 |
| engine_number | String | 发动机号码 | 主页信息 |
| register_date | String | 注册日期(YYYY.MM.DD) | 主页信息 |
| issue_date | String | 发证日期(YYYY.MM.DD) | 主页信息 |
| licence_issuing_authority | String | 发证机关 | 主页信息 |
| document_id | String | 档案编号 | 副页信息 |
| approved_passengers_capacity | String | 核定载人数 | 副页信息 |
| total_mass | String | 总质量 | 副页信息 |
| curb_weight | String | 整备质量 | 副页信息 |
| ratified_load_capacity | String | 核定载质量 | 副页信息 |
| gabarite | String | 外廓尺寸 | 副页信息 |
| traction_mass | String | 准牵引总质量 | 副页信息 |
| remarks | String | 备注 | 副页信息 |
| inspection_record | String | 检验记录 | 副页信息 |
{ "code": 10000, "data":{ "license_main":{ "address": "某某省某某县某某路", "approved_passengers_capacity": "XXXX", "curb_weight": "XXX", "document_id": "XXX", "engine_number": "ABCDEF123456", "gabarite": "XXX", "inspection_record": "XXX", "issue_date": "2014.01.01", "licence_issuing_authority": "某某省某某市公安局交通警察支队", "model": "桑塔纳12345ABCDE", "owner": "张三", "plate_number": "京ABCDEF", "ratified_load_capacity": "", "register_date": "2011.01.01", "remarks": "XXX", "total_mass": "XXX", "traction_mass": "XXX", "use_character": "非营运", "vehicle_type": "小型轿车", "vin": "ABCDCHGH123456789" } }, "message": "Success", "request_id": "6838885791079335947", "time_elapsed": "791.12641ms" }
请参考通用返回字段及错误码
| HttpCode | 错误码 | 错误消息 | 描述 |
|---|---|---|---|
| 200 | 10000 | 无 | 请求成功 |
| 400 | 50205 | "Image Size Exceeds Maximum Limit: please compress the image" | 输入文件过大 |
| 400 | 50206 | "Invalid Input Image: image is empty" | 输入图片为空 |
| 400 | 50207 | "Image Decode Error: image format unsupported" | 图片解码错误 |
| 400 | 50217 | "Process PDF File Error." | 处理PDF文件错误 |
| 400 | 60403 | "Invalid Input Image: No vehicle license detected in input image, bad input image" | 输入图片没有检测到行驶证 |
| 401 | 50400 | "Access denied due to invalid authentication information" | 鉴权失败 |
| 404 | 50402 | "Invalid Request URL" | 无效的请求路径 |
| 500 | 50500 | "Internal Error: please contact with bytedance engineering team" | 内部错误，需要联系开发人员 |