适用场景行驶证识别接口主要服务于需要从纸质或电子版行驶证图片中快速提取结构化文本的场景。传统人工录入不仅效率低还容易因视觉疲劳导致字段错位尤其在以下三类场景中价值突出二手车交易核验交易平台需要核对号牌号码、车辆识别代号VIN、准备日期、所有人等关键字段。接口一次请求即可取出全部字段配合后台数据库比对能显著提升审核速度。车辆过户信息录入车管所或代办机构每天处理大量过户业务人工抄写行驶证并录入系统耗时且易出错。接入此接口后可实现半自动化或全自动化录入减少人为差错。保险投保材料自动提取保险公司在录入投保单时需要从行驶证上获取品牌型号、使用性质、核定载质量等参数用于出单。接口返回的结构化数据可直接填充表单缩短承保周期。接口能力边界在集成前开发者需要明确以下几点能力边界识别的对象接口仅支持中华人民共和国机动车行驶证包含主页与副页的 OCR 识别不支持临时号牌、驾驶证或其他证件。测试时请使用符合规范的行驶证图片。可提取的字段共返回20 个结构化字段覆盖行驶证主页和副页的主要信息字段名含义示例plate_number号牌号码沪A12345vehicle_type车辆类型小型轿车owner所有人张三address住址上海市XX路XX号model品牌型号丰田CAMRYvin车辆识别代号LSXXXXXXXXXXXXXXXXXengine_number发动机号码4A123456register_date准备日期2020-06-01issue_date发证日期2020-06-05use_character使用性质非营运total_mass总质量kg1945curb_weight整备质量kg1495ratified_load_capacity核定载质量kg空approved_passengers_capacity核定载客人5人traction_mass准牵引总质量kg空gabarite外廓尺寸mm4885x1840x1455inspection_record检验记录2022 2024license_issuing_authority发证机关上海市公安局交通警察总队document_id档案编号SHXXXXXXXXXXremarks备注空注意部分字段如核定载质量、准牵引总质量在小型轿车中可能为空这是正常现象。请求限制QPS每秒查询数2 次/秒。若短时间内超过该上限接口会返回429状态码。建议在客户端实现请求队列或指数退避策略。鉴权要求仅限已登录用户调用。请求时必须在 Header 中携带有效的Authorization: Bearer 你的 API Key。匿名访问不开放。输入方式支持两种图片传输方式url公网图片链接和base64图片的 base64 编码可含data:image/xxx;base64,前缀。图片格式不限但建议使用 JPEG 或 PNG长边不宜超过 4096 像素。请求参数与鉴权HTTP 请求要素值请求方法POST请求地址https://v1.apizero.cn/api/ocr-vehicle-license请求头Authorization: Bearer your-api-key请求头Content-Type: application/json请求体JSON 对象包含input_type和input_data请求体字段说明字段类型必需描述input_typestring是图片传输方式可选url或base64input_datastring是图片内容。input_typeurl时填写可公网访问的图片 HTTP/HTTPS 链接input_typebase64时填写图片的 base64 字符串可包含 data URI 前缀代码接入curl 示例curl -sS -X POST \ -H Authorization: Bearer $YOUR_API_KEY \ -H Content-Type: application/json \ -d {input_type: url, input_data: https://example.com/vehicle-license.jpg} \ https://v1.apizero.cn/api/ocr-vehicle-license注意请将$YOUR_API_KEY替换为实际的 API Key。若图片为本地文件建议先上传至对象存储获得公网链接或使用 base64 方式传输。Python 示例requests 库import requests import base64 API_URL https://v1.apizero.cn/api/ocr-vehicle-license API_KEY your_api_key_here # 方式一使用图片 URL data { input_type: url, input_data: https://example.com/vehicle-license.jpg } # 方式二使用 base64以读取本地文件为例 # with open(vehicle-license.jpg, rb) as f: # img_base64 base64.b64encode(f.read()).decode(utf-8) # data { # input_type: base64, # input_data: img_base64 # } headers { Authorization: fBearer {API_KEY}, Content-Type: application/json } resp requests.post(API_URL, jsondata, headersheaders) print(resp.status_code) print(resp.json())若使用 base64 并希望保留 data URI 前缀可写为data:image/jpeg;base64,/9j/4AAQ...。返回值解读成功时 HTTP 状态码为 200响应体为 JSON 格式{ code: 0, msg: 成功, request_id: req_abc123, data: { address: 上海市XX路XX号, approved_passengers_capacity: 5人, curb_weight: 1495, document_id: SHXXXXXXXXXX, engine_number: 4A123456, gabarite: 4885x1840x1455, inspection_record: 2022 2024, issue_date: 2020-06-05, license_issuing_authority: 上海市公安局交通警察总队, model: 丰田CAMRY, owner: 张三, plate_number: 沪A12345, ratified_load_capacity: , register_date: 2020-06-01, remarks: , total_mass: 1945, traction_mass: , use_character: 非营运, vehicle_type: 小型轿车, vin: LSXXXXXXXXXXXXXXXXX } }code业务状态码。0表示识别成功非零值对应不同错误类型见下文。msg状态描述。request_id请求唯一标识可用于排查问题。data包含所有提取的字段字段名与含义见上文表格。注意字符串值可能为空字符串如未识别出的字段。常见错误与处理状态码错误说明常见原因处理建议200 code !0业务错误如图片无法识别或参数错误图片模糊、格式异常、不是行驶证根据msg调整图片确保图片内容为清晰的行驶证401UnauthorizedAPI Key 无效或未提供检查 Header 中Authorization是否正确确认 API Key 是否在有效期内400Bad Request请求体 JSON 格式错误或input_type值非法校验 JSON 结构确保字段名拼写正确429Too Many Requests超过 QPS 限制2次/秒降低请求频率实现本地队列或退避重试500Internal Server Error服务端异常重试 1~2 次若持续失败可通过request_id联系技术支持工程化注意事项图片质量保证图片正立、无遮挡、不反光长边像素建议不低于 800。过暗或过曝会影响识别率。输入方式选择如果图片已存储在对象存储OSS/S3且可公网访问优先使用 URL 方式避免在请求体中传输大量 base64 字符串增加带宽延迟。本地文件则使用 base64注意 base64 长度约为原图的 4/3需评估网络开销。限流处理QPS 上限较紧若业务并发量高建议在客户端实现令牌桶或滑动窗口限流并捕获 429 响应后采用指数退避策略如 1s、2s、4s 后重试。结果缓存对于同一张图片可通过 MD5 判断的识别结果可在本地缓存一段时间例如 24 小时避免重复调用浪费配额。字段校验返回的owner和address可能包含个人隐私在存储或展示时应注意脱敏处理如owner: 张*。参考文档接口文档页https://apizero.cn/aidocs/ocr-vehicle-license原始 Markdown 文档https://apizero.cn/aidocs/ocr-vehicle-license/raw.md
适用场景行驶证识别接口主要服务于需要从纸质或电子版行驶证图片中快速提取结构化文本的场景。传统人工录入不仅效率低还容易因视觉疲劳导致字段错位尤其在以下三类场景中价值突出二手车交易核验交易平台需要核对号牌号码、车辆识别代号VIN、准备日期、所有人等关键字段。接口一次请求即可取出全部字段配合后台数据库比对能显著提升审核速度。车辆过户信息录入车管所或代办机构每天处理大量过户业务人工抄写行驶证并录入系统耗时且易出错。接入此接口后可实现半自动化或全自动化录入减少人为差错。保险投保材料自动提取保险公司在录入投保单时需要从行驶证上获取品牌型号、使用性质、核定载质量等参数用于出单。接口返回的结构化数据可直接填充表单缩短承保周期。接口能力边界在集成前开发者需要明确以下几点能力边界识别的对象接口仅支持中华人民共和国机动车行驶证包含主页与副页的 OCR 识别不支持临时号牌、驾驶证或其他证件。测试时请使用符合规范的行驶证图片。可提取的字段共返回20 个结构化字段覆盖行驶证主页和副页的主要信息字段名含义示例plate_number号牌号码沪A12345vehicle_type车辆类型小型轿车owner所有人张三address住址上海市XX路XX号model品牌型号丰田CAMRYvin车辆识别代号LSXXXXXXXXXXXXXXXXXengine_number发动机号码4A123456register_date准备日期2020-06-01issue_date发证日期2020-06-05use_character使用性质非营运total_mass总质量kg1945curb_weight整备质量kg1495ratified_load_capacity核定载质量kg空approved_passengers_capacity核定载客人5人traction_mass准牵引总质量kg空gabarite外廓尺寸mm4885x1840x1455inspection_record检验记录2022 2024license_issuing_authority发证机关上海市公安局交通警察总队document_id档案编号SHXXXXXXXXXXremarks备注空注意部分字段如核定载质量、准牵引总质量在小型轿车中可能为空这是正常现象。请求限制QPS每秒查询数2 次/秒。若短时间内超过该上限接口会返回429状态码。建议在客户端实现请求队列或指数退避策略。鉴权要求仅限已登录用户调用。请求时必须在 Header 中携带有效的Authorization: Bearer 你的 API Key。匿名访问不开放。输入方式支持两种图片传输方式url公网图片链接和base64图片的 base64 编码可含data:image/xxx;base64,前缀。图片格式不限但建议使用 JPEG 或 PNG长边不宜超过 4096 像素。请求参数与鉴权HTTP 请求要素值请求方法POST请求地址https://v1.apizero.cn/api/ocr-vehicle-license请求头Authorization: Bearer your-api-key请求头Content-Type: application/json请求体JSON 对象包含input_type和input_data请求体字段说明字段类型必需描述input_typestring是图片传输方式可选url或base64input_datastring是图片内容。input_typeurl时填写可公网访问的图片 HTTP/HTTPS 链接input_typebase64时填写图片的 base64 字符串可包含 data URI 前缀代码接入curl 示例curl -sS -X POST \ -H Authorization: Bearer $YOUR_API_KEY \ -H Content-Type: application/json \ -d {input_type: url, input_data: https://example.com/vehicle-license.jpg} \ https://v1.apizero.cn/api/ocr-vehicle-license注意请将$YOUR_API_KEY替换为实际的 API Key。若图片为本地文件建议先上传至对象存储获得公网链接或使用 base64 方式传输。Python 示例requests 库import requests import base64 API_URL https://v1.apizero.cn/api/ocr-vehicle-license API_KEY your_api_key_here # 方式一使用图片 URL data { input_type: url, input_data: https://example.com/vehicle-license.jpg } # 方式二使用 base64以读取本地文件为例 # with open(vehicle-license.jpg, rb) as f: # img_base64 base64.b64encode(f.read()).decode(utf-8) # data { # input_type: base64, # input_data: img_base64 # } headers { Authorization: fBearer {API_KEY}, Content-Type: application/json } resp requests.post(API_URL, jsondata, headersheaders) print(resp.status_code) print(resp.json())若使用 base64 并希望保留 data URI 前缀可写为data:image/jpeg;base64,/9j/4AAQ...。返回值解读成功时 HTTP 状态码为 200响应体为 JSON 格式{ code: 0, msg: 成功, request_id: req_abc123, data: { address: 上海市XX路XX号, approved_passengers_capacity: 5人, curb_weight: 1495, document_id: SHXXXXXXXXXX, engine_number: 4A123456, gabarite: 4885x1840x1455, inspection_record: 2022 2024, issue_date: 2020-06-05, license_issuing_authority: 上海市公安局交通警察总队, model: 丰田CAMRY, owner: 张三, plate_number: 沪A12345, ratified_load_capacity: , register_date: 2020-06-01, remarks: , total_mass: 1945, traction_mass: , use_character: 非营运, vehicle_type: 小型轿车, vin: LSXXXXXXXXXXXXXXXXX } }code业务状态码。0表示识别成功非零值对应不同错误类型见下文。msg状态描述。request_id请求唯一标识可用于排查问题。data包含所有提取的字段字段名与含义见上文表格。注意字符串值可能为空字符串如未识别出的字段。常见错误与处理状态码错误说明常见原因处理建议200 code !0业务错误如图片无法识别或参数错误图片模糊、格式异常、不是行驶证根据msg调整图片确保图片内容为清晰的行驶证401UnauthorizedAPI Key 无效或未提供检查 Header 中Authorization是否正确确认 API Key 是否在有效期内400Bad Request请求体 JSON 格式错误或input_type值非法校验 JSON 结构确保字段名拼写正确429Too Many Requests超过 QPS 限制2次/秒降低请求频率实现本地队列或退避重试500Internal Server Error服务端异常重试 1~2 次若持续失败可通过request_id联系技术支持工程化注意事项图片质量保证图片正立、无遮挡、不反光长边像素建议不低于 800。过暗或过曝会影响识别率。输入方式选择如果图片已存储在对象存储OSS/S3且可公网访问优先使用 URL 方式避免在请求体中传输大量 base64 字符串增加带宽延迟。本地文件则使用 base64注意 base64 长度约为原图的 4/3需评估网络开销。限流处理QPS 上限较紧若业务并发量高建议在客户端实现令牌桶或滑动窗口限流并捕获 429 响应后采用指数退避策略如 1s、2s、4s 后重试。结果缓存对于同一张图片可通过 MD5 判断的识别结果可在本地缓存一段时间例如 24 小时避免重复调用浪费配额。字段校验返回的owner和address可能包含个人隐私在存储或展示时应注意脱敏处理如owner: 张*。参考文档接口文档页https://apizero.cn/aidocs/ocr-vehicle-license原始 Markdown 文档https://apizero.cn/aidocs/ocr-vehicle-license/raw.md
![[C++]内存管理：串顺序存储的内存回收](http://pic.xiahunao.cn/yaotu/[C++]内存管理：串顺序存储的内存回收)
