机动车行驶证识别接口（vehicle.license）：20+ 字段结构化

这个接口能解决什么问题

vehicle.license 把「看证录入」拆成一次 HTTP 请求。相比传统固定模板 OCR 只能认标准摆拍、遇到倾斜反光就全崩，本接口不依赖固定模板与定位框，能理解证照版式与上下文语义，对轻微模糊、倾斜、反光、褶皱、非标准拍摄角度的证照同样有效，核心字段识别准确率 97%~99%；拿不准的字段返回空字符串而不是猜测值，并给出置信度与质量提示，方便业务侧决定直接采信或转人工复核。

一句话说明

上传行驶证照片，一次返回 20+ 结构化字段 + 置信度；调用即计费，识别失败同样扣费。

适用场景

车险投保 / 理赔录单
二手车收车建档
车队与网约车司机资质审核
汽车金融进件、物流车辆台账、租车实名登记

接口规格

接口规格
请求地址	`https://api.xujian.tech/openapi/vehicle/license`
请求方式	POST；支持 multipart/form-data（file 字段）、application/json（image base64）、远程图片地址（imageUrl）
鉴权方式	请求头 `X-API-Key`
接口编码	`vehicle.license`
收费类型	按次计费（PER_CALL，0.1000 元/次）
计费规则	调用即计费：图片通过校验进入识别流程后，无论成功或失败（模糊 / 非行驶证 / 上游超时）都计一次费用；未传图片、超 10MB、格式不支持这类参数级错误不扣费
图片限制	单张 ≤ 10MB，支持 JPG / PNG / WEBP / BMP / GIF
典型耗时	通常 2 ~ 10 秒
典型用途	车险录单、收车建档、司机资质、汽车金融

如何调用

cURL（multipart 上传文件）

curl -s -X POST "https://api.xujian.tech/openapi/vehicle/license" -H "X-API-Key: 你的APIKey" -F "file=@/path/to/vehicle-license.jpg"

返回示例（节选，code = 0）

JSON

{
  "code": 0,
  "msg": "success",
  "data": {
    "plateNo": "渝A12345",
    "plateColor": "蓝色",
    "vehicleType": "小型轿车",
    "owner": "张三",
    "address": "重庆市巴南区……",
    "useCharacter": "非营运",
    "model": "大众牌 SVW71423BT",
    "vin": "LFV2A21KXN3XXXXXX",
    "engineNo": "A12345",
    "registerDate": "2021-06-02",
    "issueDate": "2021-06-10",
    "overallConfidence": 0.98,
    "apiCode": "vehicle.license",
    "apiName": "机动车行驶证识别",
    "chargeType": "PER_CALL",
    "balance": 99.9000,
    "costMs": 3500
  }
}

计费说明

按次计费，0.1000 元/次，调用即计费。图片通过校验进入识别流程后，无论识别成功还是失败（模糊无法识别 / 不是行驶证 / 上游超时）都计一次费用；只有未传图片、超过 10MB、格式不支持这类参数级错误返回失败且不扣费。建议在上传前做基础校验，避免无谓消耗。

常见问题

主页和副页都能识别吗？ 都能，接口自动区分版式。
识别不准的字段怎么办？ 拿不准的字段返回空字符串并给出 overallConfidence，业务侧可据此决定直接采信或转人工复核。
为什么识别失败也计费？ 因为已经调用了视觉模型算力；这是「调用即计费」口径，与查得计费的文本 / 企业类接口不同，请在上传前确保图片清晰、是行驶证。