## 一、业务背景

国内新能源汽车保有量持续上涨，不少B端系统需要根据车架号自动带出电池相关信息：

- 二手车平台展示电池配置，辅助车辆估值；

- 保险系统承保时采集电池规格，出险后定损比对原厂参数；

- 汽修汽配系统根据VIN匹配电芯、电池包、BMS原厂配件型号。

这类场景只需要车辆出厂公告的固定配置，不需要车载BMS实时检测数据，就可以使用本接口快速完成数据补全。

>⚠️ 重要提示：接口为**静态出厂档案**，无SOH、压差、循环次数等动态数据，不可用于电池衰减评估。


## 二、接口简介

传入17位标准VIN车架号，即可获取车辆基础信息、整车尺寸重量、电芯参数、电池包PACK参数、BMS厂商信息，数据源每日更新。

详见![屏幕截图 2026-09-28 111952.png](https://developer.qcloudimg.com/http-save/yehe-12701231/0312a5ec8d2c08fef89ca850dece9819.png)

### 返回字段总表

|名称|类型|说明|
|:-:|:-:|:-:|
|vin|string|车架号|
|brand_name|string|品牌|
|manufacturer|string|车辆生产企业|
|rlxs|string|动力类型|
|scale|string|车辆类别|
|driving_condition|string|标称续航（km）|
|full_weight|string|整备质量（kg）|
|full_weight_max|string|总质量（kg）|
|len|string|外形尺寸长（mm）|
|width|string|外形尺寸宽（mm）|
|height|string|外形尺寸高（mm）|
|cell_type|string|电芯类型|
|cell_supplier|string|电芯供应商|
|cell_code|string|电芯型号|
|cell_shape|string|电芯形状|
|cell_size|string|电芯尺寸（mm）|
|cell_voltage|string|电芯电压(V)|
|cell_capacity|string|电芯容量(Ah)|
|cell_count|string|电芯数量（个）|
|cell_mass|string|电芯重量(kg)|
|cell_gravimetric_energy_density|string|电芯重量能量密度(Wh/kg)|
|batt_pack_supplier|string|电池包供应商|
|batt_pack_capacity|string|标称容量(Ah)|
|batt_pack_voltage|string|电池包标称电压(V)|
|batt_pack_quantity|string|电池包电量，标称能量(kWh)|
|batt_pack_mass|string|整车电池包重量(kg)|
|batt_pack_density|string|电池包能量密度范围(Wh/kg)|
|batt_pack_combon|string|电池包组合方式|
|bms_supplier|string|BMS生产企业|

## 三、返回数据详解

返回JSON分为五大模块，下面附带样例与业务重点字段解读。

### 1. 车辆基础信息

```
{
    "vin": "LC0C74C4XT0146687",
    "brand_name": "特斯拉",
    "manufacturer": "特斯拉",
    "rlxs": "纯电动汽车",
    "scale": "SUV",
    "driving_condition": "593"
}
```
用于车辆识别、车型归类，是业务系统车辆档案的基础信息。

### 2. 尺寸与质量信息

```
{
    "full_weight": "1921",
    "full_weight_max": "2432",
    "len": "4797",
    "width": "1920",
    "height": "1624"
}
```
整车物理参数，用于载重校验、车辆档案归档。

### 3. 电芯信息

```
{
    "cell_type": "磷酸铁锂电池",
    "cell_supplier": "宁德时代",
    "cell_code": "CB280",
    "cell_shape": "方壳",
    "cell_size": "64*280*84",
    "cell_voltage": "3.2",
    "cell_capacity": "180",
    "cell_count": "108",
    "cell_mass": "3.22",
    "cell_gravimetric_energy_density": "180"
}
```
重点字段：

- `cell_type`：电芯类型（三元锂/磷酸铁锂），直接影响残值预估、保险风险等级和维修方案，是二手车、金融、保险优先关注的字段。

- `cell_supplier`：电芯原厂供应商，定损用来核验配件是否原厂，汽配平台用来匹配电芯货源，识别私自更换非原厂电芯的情况。


### 4. 电池包PACK信息

```
{
    "batt_pack_supplier": "特斯拉",
    "batt_pack_capacity": "180",
    "batt_pack_voltage": "348",
    "batt_pack_quantity": "62.5",
    "batt_pack_mass": "483",
    "batt_pack_density": "120-140",
    "batt_pack_combon": "1P108S"
}
```
重点字段：

- `batt_pack_quantity`：电池标称电量kWh，也就是常说的电池度数，二手车页面核心展示字段。

- `batt_pack_voltage`：电池包标称总电压，维修安全参考，用于电池配件匹配。

- `batt_pack_mass`：整套电池包重量，用于保险估损、吊装运输评估。

- `batt_pack_combon`：串并联组合方案，维修工程师检修、更换电池时参考。


### 5. BMS管理系统信息

```
{
    "bms_supplier": "特斯拉公司"
}
```
BMS是电池管理主板。该字段标识主板生产厂商，维修场景匹配BMS配件；定损场景核对更换的主板是否为原厂件，防范副厂件替换。

## 四、Python调用示例

接口支持GET/POST，使用平台分配的key鉴权，入参为key和17位VIN码。

```
import requests

url = ""#接口地址
params = {
    "key": "替换成你的key",
    "vin": "替换17位车架号"
}
res = requests.get(url, params=params)
print(res.json())
```
## 五、接入注意事项

1. VIN必须是标准17位车架号，建议代码中统一转大写再请求，避免格式报错；

2. 数据来源为公告档案，老旧车型、改装车、未上公告的新能源车辆可能返回无数据；

3. 本接口只提供出厂配置查询，如需SOH健康度、电芯压差、故障记录，需要单独使用电池健康报告接口。

这类场景只需要车辆出厂公告的固定配置，不需要车载BMS实时检测数据，就可以使用本接口快速完成数据补全。

VIN车架号新能源电池参数查询API｜字段解析与Python接入示例

新能源二手车、车险定损、汽配维保等业务，经常需要获取车辆原厂三电公告参数。通过17位VIN车架号查询新能源整车、电芯、电池包、BMS出厂静态档案的API，拆解返回JSON字段含义，并提供可直接调试的Python示例。

后端

开发工具

大数据

输入17位车架号VIN，即刻获取新能源车电池档案数据，覆盖电芯类型、供应商、型号及电池包PACK参数，辅助二手车估值、保险定损及汽配维修场景。数据每日更新，支持特斯拉、宁德时代等主流品牌，纯静态出厂配置，无动态健康数据。接入简单，GET/POST调用，快速响应，助力系统电池信息补全。

代码解释

Python

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

VIN车架号新能源电池参数查询API｜字段解析与Python接入示例-腾讯云开发者社区-腾讯云

VIN车架号新能源电池参数查询API｜字段解析与Python接入示例

VIN车架号新能源电池参数查询API｜字段解析与Python接入示例

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐