车辆估值

根据上牌省份、注册日期、车型等字段，检索二手成交 / 挂牌样本，输出价格区间。

接口

方法	路径	说明
POST	/api/open/v1/vehicle-valuations	创建并后台执行
GET	/api/open/v1/vehicle-valuations/{taskId}	查询详情
POST	/api/open/v1/vehicle-valuations/stream	创建并 SSE

通用约定见 约定与通用响应。

请求体

Content-Type: application/json

字段	类型	必填	说明	示例
province	string	是	上牌省份	广东省
registrationDate	string	是	注册日期，YYYY-MM 或 YYYY-MM-DD	2020-06
marketingModel	string	建议	市场/营销车型名。与 registrationModel 至少填一项	特斯拉 Model 3 后轮驱动版
registrationModel	string	建议	行驶证「品牌型号」原文（OCR 场景）
mileage	number	否	里程（万公里）	3.2
condition	string	否	EXCELLENT 优秀 / GOOD 良好 / FAIR 一般	GOOD
vin	string	否	车架号
suggestedSearchKeyword	string	否	OCR 建议检索词
confirmedModelId / confirmedModelName	string	否	已确认车型；不传则由服务端处理
marketingModelInferred	boolean	否	营销型号是否为系统推测
materialFileName	string	否	OCR 材料文件名	行驶证.jpg
materialRef	string	否	OCR 材料引用
source	string	否	对话闭环传 CHAT
chatSessionId	number	否	对话会话 ID

查询参数：callbackUrl（可选）。

创建示例

curl -s -X POST "http://localhost:8080/api/open/v1/vehicle-valuations" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: aai_你的密钥" \
  -d '{
    "province": "广东省",
    "registrationDate": "2020-06",
    "marketingModel": "特斯拉 Model 3 后轮驱动版",
    "mileage": 3.2,
    "condition": "GOOD"
  }'

成功时 result

金额为人民币元。

字段	类型	说明
confidence	number	置信度
effectiveSampleCount	integer	有效样本数
recentSixMonthsCount	integer	近 6 个月样本数
minTotalPrice / avgTotalPrice / maxTotalPrice	number	总价下限 / 中枢 / 上限
publishMatrix / dealMatrix	object	挂牌 / 成交价格矩阵
riskTips	string[]	风险提示
sources	object[]	样本来源
generatedAt	string	生成时间

SDK

const detail = await client.vehicle.valuate({
  province: "广东省",
  registrationDate: "2020-06",
  marketingModel: "特斯拉 Model 3 后轮驱动版",
  mileage: 3.2,
  condition: "GOOD",
});