vinrecognition

极速数据 VIN 识别（Jisu VINRecognition）

基于 VIN 识别 API 的 OpenClaw 技能，支持：

• 对车辆挡风玻璃处或行驶证上的车架号照片进行 OCR 识别；
• 返回车架号 VIN、是否正确标记、品牌、厂家名称等信息。

适合用于车辆验真、档案录入、二手车评估等场景。

使用技能前需要申请数据，申请地址：https://www.jisuapi.com/api/vinrecognition/

环境变量配置

# Linux / macOS
export JISU_API_KEY="your_appkey_here"

# Windows PowerShell
$env:JISU_API_KEY="your_appkey_here"

脚本路径

脚本文件：skills/vinrecognition/vinrecognition.py

使用方式

当前脚本通过调用 /vinrecognition/recognize 接口，对单张图片进行 VIN 识别。

1. 从本地图片识别 VIN

python3 skills/vinrecognition/vinrecognition.py '{"path":"vin.jpg"}'

2. 直接传 base64 图片内容

python3 skills/vinrecognition/vinrecognition.py '{
  "pic": "<base64-encoded-image>"
}'

提示：pic 字段是图片二进制内容的 base64 编码（不带 data:image/...;base64, 前缀），
也可以使用 image / file 字段传本地路径，脚本会自动读取并转为 base64。

请求参数

JSON 请求体字段说明：

当未提供 pic 时，脚本会优先从 path/image/file 中读取本地图片并进行 base64 编码。

返回字段

成功时，脚本直接输出接口 result 字段，典型结构：

{
  "vin": "LFV2A21K0G4053021",
  "iscorrect": 1,
  "brand": "大众",
  "manufacturer": "一汽大众"
}

字段说明：

当出现错误（如图片为空、格式不对、超过大小限制等）时，脚本会输出统一错误结构：

{
  "error": "api_error",
  "code": 201,
  "message": "图片为空"
}

常见错误码

业务错误码（来源于官网文档）：

系统错误码：

在 OpenClaw 中的推荐用法

1. 用户上传一张挡风玻璃或行驶证照片，提问：「帮我识别下这辆车的 VIN、品牌和厂家」。
2. 代理将图片保存为临时文件路径（如 vin.jpg），调用：
   python3 skills/vinrecognition/vinrecognition.py '{"path":"vin.jpg"}'
3. 从返回结果中读取 vin/iscorrect/brand/manufacturer 字段，用自然语言总结给用户；如有需要，还可以结合 vin/query 接口获取更详细的车辆配置信息。