VIN Recognition/Decoder

This API extract vin from ID cards, labels, receipts, invoices, documents, barcodes, etc and returns the information such as the manufacturer, model, year, country of origin and much more..

原始信息汇总

VIN Recognition/Decoder API 总结

基本信息

• 数据集/API 页面：https://rapidapi.com/belchiorarkad-FqvHs2EDOtP/api/vin-recognition-decoder
• 名称：VIN Recognition/Decoder
• 类别：Visual Recognition
• API 版本：v1 (current)
• 提供者：Pinto Studio
• 订阅者：150
• 评分：(0)
• 流行度：8.3
• 服务等级：33%
• 延迟：1517ms
• 测试：N/A

订阅计划

计划	价格
BASIC	$0.00
PRO	$18.99
ULTRA	$59.99
MEGA	$167.94

功能概述

• 从图像中提取 VIN，图像来源可包括身份证、标签、收据、发票、文档、条形码等。
• 使用高级图像识别技术识别并解码 VIN。
• 解码 VIN 后可获取制造商、型号、年份、原产国等信息。
• 支持仅输入 VIN 文本并获取车辆信息。
• 适用于汽车销售、保险、维护等场景，减少手动录入和人为错误。
• 识别与解码效果可能受图像质量、分辨率、角度影响，建议使用高质量图像并确保 VIN 清晰可见。

核心能力

• 解码 VIN 为品牌、型号、车型年、配置、车身、发动机、变速箱、工厂及 100+ 规格。
• 从照片读取 VIN：门框贴纸、仪表板标牌、挡风玻璃标签、登记文件。
• 获取召回、车主投诉、NHTSA 碰撞测试评级、EPA 燃油经济性。
• 验证 VIN：长度、非法字符、校验位，无需完整解码。
• 批量解码最多 50 个 VIN。
• 一键车辆报告，组合以上多项数据。

请求与响应格式

• 所有请求通过 RapidAPI，需发送 X-RapidAPI-Key 和 X-RapidAPI-Host 请求头。
• VIN 参数大小写不敏感，空格、破折号、点会被忽略。
• GET /decode、GET /decode-basic、GET /validate、GET /report、GET /history-check 也接受 VIN 作为路径段。

成功响应

json { "success": true, "data": { }, "meta": { "requestId": "…", "tookMs": 123, "warnings": ["…"] } }

• meta.warnings 仅在需要注意时出现，例如校验位不匹配，应始终读取。

错误响应

json { "success": false, "error": { "code": "INVALID_VIN", "message": "VIN must be exactly 17 characters, got 16.", "details": { } }, "meta": { "requestId": "…" } }

• error.code 稳定，应基于它构建逻辑。
• error.message 人类可读，措辞可能变化。
• error.details 为可选额外上下文，例如修正后的 VIN 建议。
• 联系支持时引用 meta.requestId。

端点

解码与验证

• GET /decode：完整解码。
  • 参数：vin 必填，17 字符；compact 可选，true 仅返回摘要，不含长 specs；modelYear 可选，位置 10 模糊时使用；strict 可选，true 时校验位错误拒绝并返回 422。
  • 返回：摘要字段、specs、decodeQuality、possibleModelYears、origin。
  • decodeQuality 值：complete、partial、not_found。
  • 别名：/get-vin、/get-vin2。
• GET /decode-basic：即时离线解码。
  • 不使用外部数据源，最快最可靠。
  • 返回：区域、国家、制造商、WMI/VDS/VIS 部分、车型年候选、工厂代码、序列号。
  • 适用于任何国家的 VIN。
  • 别名：/simple-vin。
• GET /validate：验证 VIN。
  • 返回：valid、structurallyValid、checkDigit { required, actual, expected, valid }、errors[]、warnings[]、suggestion。
  • 当 VIN 包含 I、O、Q 时返回 suggestion，这些字符不用于 VIN。
  • 即使 VIN 无效也总是返回 HTTP 200。
• POST /decode/batch：批量解码。
  • 请求体：{ "vins": ["…", "…"] }
  • 最多 50 个 VIN。
  • 每个条目有独立 success 标志和 data 或 error。
  • 添加 ?full=true 包含 specs。

图像识别

• POST /extract-vin：从图像读取 VIN。
  • 发送方式：
    • 文件上传：multipart/form-data，字段名 file 或 image。
    • Base64：JSON { "image_base64": "<base64 或 data:image/...;base64,...>" }
    • 公共 URL：JSON { "image_url": "https://…/photo.jpg" }
  • 查询参数：
    • decode：默认 true，同时解码找到的 VIN；false 为更快 OCR-only 结果。
    • include_text：true 返回原始 OCR 文本。
  • 支持格式：JPEG、PNG、WEBP、BMP、GIF、TIFF，最大 8 MB。
  • 响应包括：vin、checkDigitValid、correctedFromOcr、alternatives[]、vehicle。
  • 别名：/extract-vin34。

车辆数据与报告

• GET /report：一次调用获取全部。
  • ?vin=… 返回：vehicle、recalls、complaints、safetyRatings、fuelEconomy、history。
  • 并行获取。若某源宕机，该 section 为 null，原因在 meta.sectionErrors，其余仍返回。
• GET /recalls：获取 NHTSA 安全召回。
  • 接受 vin，或 make + model + year。
  • 返回字段：campaignNumber、component、summary、consequence、remedy、reportReceivedDate、parkIt、parkOutside、overTheAirUpdate。
  • 最新召回在前。
• GET /complaints：获取投诉。
  • 接受 vin，或 make + model + year。
  • 可选参数：limit 默认 20，最大 100；offset 默认 0；component 按组件过滤。
  • 返回 summary，含总数、碰撞、火灾、受伤、死亡和 top 10 components，以及一页投诉，最新在前。
• GET /safety-ratings：获取 NHTSA 5 星评级。
  • 接受 vin，或 make + model + year。
  • 返回 overall、frontal、side、pole、rollover 评级，安全技术，以及每个车身风格的碰撞测试照片链接。
• GET /fuel-economy：获取 EPA 燃油经济性。
  • 接受 vin，或 make + model + year。
  • 返回每个变体的 City、highway、combined MPG；电动车返回 kWh per 100 miles 和 range；CO₂ grams per mile；年度燃料成本和 EPA 分数。
  • 使用 VIN 时，匹配解码发动机的变体标记 bestMatch: true。
• GET /history-check：获取历史记录数量。
  • ?vin=… 返回 damages、odometerReadings、events、photos 数量及 hasDamageRecords。
  • 仅返回数量，不返回记录本身。

参考与健康

• GET /wmi：?code=1HG 取 VIN 前 3 字符，返回制造商、区域、国家。
• GET /makes：/makes?type=car&search=hon，type 可选，例如 car、truck、motorcycle、bus、multipurpose passenger vehicle (mpv)。
• GET /models：/models?make=honda&year=2020&type=car，year 和 type 可选。
• GET /health：存活检查。

错误码

HTTP	error.code	含义 / 操作
400	MISSING_VIN	添加 ?vin=
400	INVALID_VIN	长度或字符错误。查看 details.errors 和 details.suggestion
422	CHECK_DIGIT_MISMATCH	仅 strict=true 返回。VIN 可能打错
422	VEHICLE_NOT_IDENTIFIED	无法解码 make、model 或 year，模型级数据不可用。改传 make、model、year
400	MISSING_VEHICLE	传 vin，或完整传 make、model、year
400	INVALID_YEAR、INVALID_LIMIT、INVALID_OFFSET、INVALID_WMI、MISSING_MAKE	修复参数
400	MISSING_VINS	批量请求体必须为 {"vins": [...]}
413	TOO_MANY_VINS	每批不超过 50 个 VIN
400	INVALID_JSON	请求体不是有效 JSON
400	MISSING_IMAGE、INVALID_UPLOAD、INVALID_BASE64、INVALID_IMAGE_URL、IMAGE_DOWNLOAD_FAILED、EMPTY_IMAGE	修复图像输入
413	IMAGE_TOO_LARGE、PAYLOAD_TOO_LARGE	图像需 8 MB 或更小
415	UNSUPPORTED_IMAGE_TYPE	发送 JPEG、PNG、WEBP、BMP、GIF 或 TIFF
422	VIN_NOT_FOUND_IN_IMAGE	图像中无可读 VIN。重拍照片
404	WMI_NOT_FOUND、ROUTE_NOT_FOUND	未知 WMI 或端点
503	BUSY	太多图像正在处理。按 Retry-After 头重试
502	UPSTREAM_UNAVAILABLE	数据源暂时不可用。稍后重试
504	UPSTREAM_TIMEOUT、OCR_TIMEOUT	重试。OCR 可发送更小更清晰图像
500	INTERNAL_ERROR	重试。若持续，带 requestId 联系支持

• 仅重试 502、503、504，使用退避，例如 2 秒、5 秒、15 秒。
• 重试 4xx 会得到相同答案，并仍消耗配额。

数据覆盖与准确性

数据	来源	覆盖
Specs (/decode)	NHTSA vPIC	最适合美国、加拿大销售车辆。欧洲和亚洲市场 VIN 通常可得到 make、manufacturer、plant country、model year，但常无 model 或 engine
Offline decode (/decode-basic、/validate、/wmi)	ISO 3779 和 WMI registry	全球
Recalls、complaints、crash ratings	NHTSA	美国市场车辆
Fuel economy	US EPA (https://fueleconomy.gov)	美国市场车辆，1984 及以后车型年
History counts	第三方车辆历史索引	因车辆而异；美国、欧洲销售车辆最强

车型年

• 北美：VIN 位置 10 加位置 7 给出单一年份。
• 其他地区：位置 10 可表示相隔 30 年的两个年份，例如 E = 2014 或 1984。API 返回最接近的合理年份，并在 possibleModelYears 列出所有候选。
• 北美以外部分制造商不编码年份。

校验位

• 位置 9 在北美和中国是强制的。
• 其他地区常只是填充，因此校验位不匹配仅为警告。

使用建议

Do

• 用户输入 VIN 时先用 /validate 或 /decode-basic 验证，捕获拼写错误。
• 仅需主要字段时在 /decode 使用 compact=true，响应约减半。
• VIN 列表使用 /decode/batch，而非多次单次调用。
• 一个 VIN 需要多个数据集时使用 /report，一次请求代替五次。
• 信任结果前检查 meta.warnings 和 decodeQuality。
• 在侧缓存结果。VIN 规格不变；召回和投诉变化慢，每日刷新足够。
• 拍照提示：裁剪到 VIN 区域；正面拍摄，光线好，无眩光；VIN 文本至少约 30 px 高；门框贴纸和登记文件读取最好；冲压车架号最难。
• OCR 结果 checkDigitValid 为 false 时，向用户展示 alternatives，让其确认 VIN。
• 按 error.code 处理错误，而非仅看 HTTP 状态或消息文本。

Dont

• 不发送 1981 年前或非标准 ID，如少于 17 字符、底盘号或车架号。
• 不自行修复 I、O、Q，它们从不出现在 VIN 中；/validate 会返回 suggestion。
• 不期望每个国家都有完整细节。
• 不把 /recalls 当作某辆车仍需要维修的证据；召回按 make、model、year 列出。特定车辆是否已修复只有制造商或 https://nhtsa.gov/recalls 的 VIN 查询可知。
• 不把 /history-check 当作完整历史报告；它只告诉有多少记录，不告诉内容。
• 不发送巨大图像或 PDF；照片长边调整到约 1500–2500 px，更快且通常更准确。
• 不以循环重试 4xx 错误。
• 不从公共网页或移动应用直接调用 API 并嵌入 RapidAPI key；应通过后端代理。
• 不单独使用此数据做法律、保险或安全关键决策，需对照官方文件确认。

FAQ 要点

• 欧洲 VIN 的 model 为 null：美国政府数据库只有北美销售车辆完整数据。仍可得到 make、manufacturer、country、year。用 /decode-basic 获取结构数据。
• /recalls?vin=… 返回 422 VEHICLE_NOT_IDENTIFIED：VIN 无法解析到模型。改调用 /recalls?make=…&model=…&year=…。
• 得到多个燃油经济性变体：EPA 分别列出每个发动机和变速器。按 VIN 查询时，匹配解码发动机的变体标记 bestMatch: true。
• 图像是否存储：不。图像在内存处理，响应发送后立即丢弃。

支持与提供者

• 支持：Telegram @pintoflow，报告问题时包含 meta.requestId。
• API 创建者：Pinto Studio
• 订阅者：150
• 类别：Visual Recognition

搜集汇总

背景与挑战

背景概述

该数据集提供VIN识别与解码API，能够从身份证、标签、收据、发票、条形码等多种文档中提取车辆识别码。它返回包括制造商、型号、年份和原产国在内的详细信息。