接口能力与调用限制概览行驶证识别API专注于将行驶证图片结构化解析为20余个字段涵盖号牌号码、车辆类型、所有人、VIN等核心信息。该接口主要用于二手车交易核验、保险投保材料自动提取、车辆档案电子化等场景。与大多数在线OCR服务一样本接口存在明确的调用限制开发者需要提前了解这些边界以避免生产环境突发错误。关键限制参数参数值说明最大QPS每秒请求数2超出该频率将返回429Too Many Requests图片输入方式url / base64支持公网图片链接或Base64编码鉴权方式Bearer Token通过请求头Authorization: Bearer API Key传递请求体大小以文档为准base64编码后大小受限于服务端配置注意该接口仅限已登录用户调用匿名访问不开放。使用前需要获取有效的API Key并妥善保管。请求参数与鉴权Header参数参数是否必填类型说明Authorization是string格式Bearer 你的API KeyContent-Type否string推荐设为application/json请求体结构请求体为JSON对象包含两个必填字段input_typestring图片传输方式可选url或base64。input_datastring图片内容。当input_type为url时传入图片的HTTP/HTTPS链接当input_type为base64时传入图片的Base64编码字符串可含data:image/xxx;base64,前缀。请求示例JSON{ input_type: url, input_data: https://example.com/vehicle-license.jpg }可复制的curl请求示例以下curl命令演示如何调用行驶证识别API请将$APIZERO_API_KEY替换为你的真实API Keycurl -sS \ -X POST \ -H Authorization: Bearer $APIZERO_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若图片为本地文件可先将其转换为Base64再通过input_typebase64发送# 假设图片文件为 ./license.jpg BASE64_DATA$(base64 -w0 ./license.jpg) curl -sS -X POST \ -H Authorization: Bearer $APIZERO_API_KEY \ -H Content-Type: application/json \ -d {\input_type\: \base64\, \input_data\: \$BASE64_DATA\} \ https://v1.apizero.cn/api/ocr-vehicle-license返回字段解读成功响应HTTP 200的JSON结构如下{ code: 0, 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 }, msg: 成功, request_id: req_abc123 }各字段含义如下字段类型说明codeint业务状态码0表示成功非0表示异常msgstring状态描述request_idstring本次请求的唯一标识可用于排障dataobject识别结果包含20个字段具体字段见上表常见data字段包括plate_number号牌号码、vehicle_type车辆类型、owner所有人、address住址、model品牌型号、vin车辆识别代号、engine_number发动机号、register_date准备日期等。部分字段如ratified_load_capacity、traction_mass、remarks可能为空字符串需在业务中做空值处理。常见错误与限流处理HTTP状态码与业务错误码状态码业务码含义处理建议4011鉴权失败API Key缺失或无效检查Authorization头是否正确确保API Key未过期429101请求频率超过QPS限制2/s增加退避延迟或使用请求队列500-1服务端内部错误重试请求若持续失败请查阅文档或联系支持QPS限流的工程应对由于QPS上限仅为2在需要批量识别行驶证如处理数百张图片时必须控制并发请求速率。以下是一个基于令牌桶的简易Python限流示例import time import requests class RateLimiter: def __init__(self, max_per_second2): self.max_per_second max_per_second self.min_interval 1.0 / max_per_second self.last_request_time 0 def wait(self): now time.time() elapsed now - self.last_request_time if elapsed self.min_interval: time.sleep(self.min_interval - elapsed) self.last_request_time time.time() API_KEY your_api_key_here URL https://v1.apizero.cn/api/ocr-vehicle-license limiter RateLimiter(max_per_second2) image_urls [ https://example.com/car1.jpg, https://example.com/car2.jpg, # ...更多图片链接 ] for img_url in image_urls: limiter.wait() # 确保不超过QPS payload { input_type: url, input_data: img_url } headers { Authorization: fBearer {API_KEY}, Content-Type: application/json } resp requests.post(URL, jsonpayload, headersheaders) if resp.status_code 429: # 仍被限流说明间隔计算有误差或服务端统计窗口不同可增加固定等待 time.sleep(0.5) continue elif resp.status_code ! 200: # 其他错误记录日志 print(fError for {img_url}: {resp.status_code} {resp.text}) continue result resp.json() if result[code] 0: print(f识别成功: {result[data][plate_number]}) else: print(f业务错误: {result})重试策略对于返回429或5xx的错误建议采用指数退避重试。例如第一次等待1秒第二次等待2秒第三次等待4秒最多重试3次。注意如果连续收到429可能是整体并发过大需要降低请求速率。工程化注意事项1. 图片预处理图片分辨率建议不低于300×300像素清晰且无遮挡。若使用Base64需注意编码后大小不超过服务端限制通常几百KB到几MB具体以文档为准。避免上传倾斜角度过大的图片可能导致识别字段缺失。2. 异步处理与回调对于大批量请求建议采用异步消息队列如Redis Celery将请求分发到后台worker每个worker内部使用RateLimiter控制发送频率。识别结果可写入数据库或回调用户。3. 缓存结果对于相同图片的重复识别请求可在应用层缓存结果如根据图片MD5值存储减少API调用量同时避免触碰QPS限制。4. 监控与报警监控API调用成功率、429频率、平均响应时间。设置阈值报警当429比例超过5%时触发限流策略调整通知。5. 字段空值处理返回数据中部分字段如ratified_load_capacity、traction_mass可能为空字符串业务层需要做缺省值判断避免因空值引发SQL错误或前端展示异常。参考文档行驶证识别API 原始文档行驶证识别API 在线文档
