您需要可靠的车辆价格数据来推动本周的财务工作流程——承保汽车贷款、估算租赁定价的残值、计算资产会计的折旧,或在经销商信用额度中执行评估规则。在本指南结束时,您将能够查询VIN并使用Zyla API Hub上的车辆价值计算器API返回市场价格统计(平均值、分布、里程调整、确定性和日期范围),将其集成到Python或curl中,并可选择通过MCP端点将其连接到AI代理。
此API为财务用例提供的内容
车辆价值计算器API返回通过VIN识别的车辆的市场导出定价指标。对于财务团队和开发人员,这使得:
- 贷款承保:将请求的贷款金额与当前市场价值和标准差带进行比较,以限制LTV。
- 租赁:利用均值和分布来告知残值模型和风险缓冲。
- 投资组合监控:定期重新评估抵押品,并在确定性或平均值偏离时生成警报。
- 采购和再营销:在拍卖之前检查公平购买或转售范围。
响应包括:
- 车辆标识符和标题(例如,“2001 Infiniti I30 Luxury”)。
- 摘要统计:平均价格、标准差、观察计数、确定性分数。
- 观察期为YYYY-MM-DD日期。
- 价格带(平均、以下、以上)和按桶划分的价格分布。
- 显示平均里程、输入里程和计算调整值的里程调整部分。
这些字段在财务规则引擎中是立即可操作的——将“均值”插入LTV检查中,使用“标准差”来调整风险溢价,并保留“期间”以便审计。在列表中未指定货币或单位约定的情况下,将数字字段视为金额,并与您的业务利益相关者确认任何假设。日期为ISO样字符串,如示例所示。
在Zyla API Hub上开始
打开API页面,订阅并复制您的密钥——一个帐户,一个API密钥,一个订阅模型,适用于Zyla上的数千个API。
- 转到车辆价值计算器API列表,选择订阅或开始免费试用(可用时)。
- 复制您的API密钥并在Authorization头中使用它,格式为Bearer YOUR_API_KEY。
- 从您的应用程序或终端发出第一次请求。
Zyla API Hub提供超过10,000个公共API,采用订阅+配额模型(而非按调用计费)。对于此API,您可以根据当前访问选项开始7天试用或50个请求;请查看列表以获取详细信息。在Zyla API Hub上探索更多类别。
您今天可以调用的端点
所有请求使用Authorization: Bearer YOUR_API_KEY。仅应发送下面明确记录的参数。
1) 获取车辆价格数据
方法:GET
URL:https://zylalabs.com/api/3624/vehicle-value-calculator-api/4063/get-vehicle-price-data
描述:提供VIN以检索当前市场价格数据。列表中注明了可选参数,例如里程,但此处仅指定了必需的VIN参数。
- vin(字符串,必需):例如,JNKCA31A61T027494
curl示例(复制粘贴):
curl -s -X GET "https://zylalabs.com/api/3624/vehicle-value-calculator-api/4063/get-vehicle-price-data?vin=JNKCA31A61T027494" \
-H "Authorization: Bearer YOUR_API_KEY"
官方示例响应:
{
"status": true,
"code": 200,
"data": {
"vin": "JNKCA31A61T027494",
"success": true,
"id": "2001_infiniti_i30_luxury",
"vehicle": "2001 Infiniti I30 Luxury",
"mean": 4427.14,
"stdev": 1066,
"count": 18,
"mileage": 100000,
"certainty": 91,
"period": [
"2024-06-15",
"2024-12-04"
],
"prices": {
"average": 4427.14,
"below": 3360.23,
"above": 5494.05,
"distribution": [
{
"group": {
"min": 2095,
"max": 2350,
"count": 2
}
},
{
"group": {
"min": 2350,
"max": 2690,
"count": 2
}
},
{
"group": {
"min": 2690,
"max": 3555,
"count": 2
}
},
{
"group": {
"min": 3555,
"max": 3999,
"count": 2
}
},
{
"group": {
"min": 3999,
"max": 4200,
"count": 2
}
},
{
"group": {
"min": 4200,
"max": 4250,
"count": 1
}
},
{
"group": {
"min": 4250,
"max": 4500,
"count": 2
}
},
{
"group": {
"min": 4500,
"max": 4990,
"count": 2
}
},
{
"group": {
"min": 4990,
"max": 5250,
"count": 2
}
},
{
"group": {
"min": 5250,
"max": 5697,
"count": 1
}
}
]
},
"adjustments": {
"mileage": {
"average": 153135.17,
"input": 100000,
"adjustment": 463
}
}
},
"message": "数据成功获取!"
}
如何在财务工作流程中读取此内容:
- data.mean:用作LTV检查的当前抵押品价值基线。
- data.stdev:基于风险定价的敏感性(例如,当标准差高时添加溢价)。
- data.count:观察的近似范围;与确定性结合以设置信心等级。
- data.certainty:指示估计在该期间内的稳定性或代表性的分数。
- data.prices.average/below/above:为批准定义保守和激进的定价区间。
- data.prices.distribution:用于欺诈检查的桶状范围(例如,声明的价格超出合理范围)。
- data.adjustments.mileage:显示输入里程和与平均里程相比的调整。对于残值微调或减值测试非常有用。
- data.period:观察市场数据的日期范围。将这些字符串存储以便审计和时间加权模型。格式为YYYY-MM-DD。
2) 获取制造商
方法:GET
URL:https://zylalabs.com/api/3624/vehicle-value-calculator-api/4064/get-makers
描述:返回所有支持的制造商。未记录请求参数,超出身份验证。
curl示例:
使用此功能填充UI选择器,以便在VIN搜索工具中使用,或在融资申请中验证表单输入。
3) 获取车型
方法:GET
URL:https://zylalabs.com/api/3624/vehicle-value-calculator-api/4065/get-models
描述:列出给定制造商的所有车型。
- maker(字符串,必需):例如,audi
curl示例:
使用此功能在VIN尚不确定时推动财务输入表单中的级联选择。
一个文件:curl到生产,然后是Python调用
您可以使用上面的curl从终端调用价格端点。以下是一个最小的Python示例,它检索相同的VIN,检查批准阈值并打印与财务相关的值。将YOUR_API_KEY替换为您的密钥。
import requests
API_URL = "https://zylalabs.com/api/3624/vehicle-value-calculator-api/4063/get-vehicle-price-data"
VIN = "JNKCA31A61T027494"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
resp = requests.get(API_URL, headers=headers, params={"vin": VIN}, timeout=20)
resp.raise_for_status()
data = resp.json()
# 合理性检查
if not data.get("status") or data.get("code") != 200 or not data.get("data", {}).get("success"):
raise RuntimeError(f"查找失败:{data}")
veh = data["data"]
mean_price = veh["mean"]
stdev = veh["stdev"]
count = veh["count"]
certainty = veh["certainty"]
period_start, period_end = veh["period"][0], veh["period"][1]
avg_band = veh["prices"]["average"]
below_band = veh["prices"]["below"]
above_band = veh["prices"]["above"]
mileage_input = veh["adjustments"]["mileage"]["input"]
mileage_adj = veh["adjustments"]["mileage"]["adjustment"]
# 示例财务规则:如果请求的贷款 <= 90% 的均值且确定性 >= 80,则批准
requested_loan = 0.9 * mean_price # 用您的输入值替换
approve = (requested_loan <= 0.90 * mean_price) and (certainty >= 80)
print({
"vehicle": veh["vehicle"],
"vin": veh["vin"],
"mean_price": mean_price,
"stdev": stdev,
"count": count,
"certainty": certainty,
"period": (period_start, period_end),
"bands": {"average": avg_band, "below": below_band, "above": above_band},
"mileage_input": mileage_input,
"mileage_adjustment": mileage_adj,
"approve": approve
})
注意:
- 身份验证:使用Authorization: Bearer YOUR_API_KEY。
- 超时和重试:对于生产财务流程(例如,承保屏幕),添加重试和退避以及断路器。
- 缓存:如果您在短时间内多次获取相同的VIN,请考虑按VIN和期间缓存JSON,以限制延迟和成本。此端点未指示分页。
- 单位和货币:列表显示数字金额;未指定货币。将输出与您的市场配置对齐。
财务本地实现模式
承保和LTV检查
- LTV基线 = requested_loan / mean。
- 如果标准差超过您的投资组合阈值或确定性低于最低值,则提高风险溢价。
- 如果声明的价格落在[以下,以上]区间之外或超出所有分布桶,则标记申请。
租赁的残值建模
- 使用均值作为当前的预期转售价值;根据您的折旧曲线向前滚动。
- 利用标准差构建置信区间;在方差高的地方调整准备金。
- 当实际里程偏离平均值时,将里程调整作为残值的修正。
抵押品监控和减值
- 按计划重新运行定价,并为每个快照保留期间开始/结束。
- 当均值下降到设定的增量或确定性下降时,触发减值审查。
- 使用计数检测薄弱市场,您可能希望进行人工审查。
经销商地板计划和审计
- 在审计期间,交叉检查抵押车辆声明的价值与均值和分布桶。
- 当声明的价值远高于“以上”或低于“以下”时,升级处理。
通过MCP从AI代理调用API
如果您的承保或评估助手作为MCP兼容代理(Claude Code、Cursor、Windsurf等)运行,您可以通过Zyla的MCP网关路由调用。MCP端点可在专用URL上使用,该URL接受您的Zyla API密钥。请参阅此处的文档:MCP。
- 当您的MCP客户端转发请求时,使用相同的Authorization模式(Bearer YOUR_API_KEY)。
- 调用上面记录的确切中心端点,例如带有?vin=...的获取车辆价格数据URL。
- 在工具设计中,将vin作为必需参数暴露,并将均值、标准差、确定性、区间和期间直接返回给代理,以便进行确定性提示。
由于财务工作流程通常需要可解释性,请在代理的响应中包含期间和分布,以证明诸如“待收入验证批准”或“因LTV违规而拒绝”等决策。
节省时间的操作细节
- 身份验证:始终发送Authorization: Bearer YOUR_API_KEY。请勿将密钥放在URL中。
- 观察期:返回为两个日期字符串;存储两者以追踪用于决策的市场窗口。
- 里程:列表中注明了可选参数,例如里程;响应包括里程输入和调整值。如果您收集里程表读数,请在审计日志中将其与响应字段进行核对。
- 错误处理:将status=true和code=200以及data.success=true视为成功信号。
- 幂等性:GET请求在网络故障时可以安全重试。
- 配额:Zyla使用订阅+配额。首次访问通常提供7天试用或50个请求——请查看列表以确认当前选项。
财务的端到端示例
1) 实时贷款决策
- 从申请人处收集VIN。
- 查询获取车辆价格数据。
- 使用均值计算LTV;与按确定性分级的政策阈值进行比较。
- 在决策记录中保留均值、标准差、确定性、期间和VIN。
- 返回批准/待定/拒绝,并附上包括期间和价格区间的解释。
2) 每月抵押品刷新
- 批量处理您的活动VIN。
- 为每个VIN调用价格端点,按调度程序间隔。
- 如果均值下降到配置的百分比或确定性下降,则标记风险。
- 使用CSV通知投资组合经理,包括vin、车辆、均值、标准差、确定性、期间。
3) 租赁残值设置
- 获取当前均值和里程调整。
- 应用您的月度折旧曲线;添加按标准差缩放的方差缓冲。
- 发布残值计划并存储原始期间以便追踪。
参考:端点和参数
- 获取车辆价格数据(GET):https://zylalabs.com/api/3624/vehicle-value-calculator-api/4063/get-vehicle-price-data
- 必需参数:vin
- 获取制造商(GET):https://zylalabs.com/api/3624/vehicle-value-calculator-api/4064/get-makers
- 未记录请求参数
- 获取车型(GET):https://zylalabs.com/api/3624/vehicle-value-calculator-api/4065/get-models
- 必需参数:maker
接下来去哪里
在列表上订阅,将curl放入您的终端,并将Python示例连接到您的承保或评估微服务。Zyla为您提供一个密钥、一个订阅和跨其超过10,000个API目录的一致头部——在您需要快速增强财务工作流程时非常有用。在Zyla API Hub主页上探索更多选项,然后返回这里完成您的车辆定价集成。
常见问题
我使用什么头部进行身份验证?
在每个请求中发送Authorization: Bearer YOUR_API_KEY。
价格端点支持VIN以外的参数吗?
列表中注明了可选参数,例如里程。此处仅记录了必需的vin参数;请查阅API页面以获取其他选项。
价格以什么货币计算?
列表未指定货币。将数字字段视为金额;与您的运营市场对齐,并与您的利益相关者确认假设。
我应该如何解释批准的确定性和标准差?
将确定性作为市场稳定性的信心指标,将标准差作为离散度量。许多团队在确定性较低或标准差较高时收紧LTV阈值。
是否有免费计划?
访问使用订阅+配额,而不是按调用计费。请查看API页面以获取当前访问选项和定价;首次访问通常提供7天试用或50个请求。
准备好构建了吗?在这里开始您的集成并获取您的API密钥:在车辆价值计算器API上开始7天试用。