图像

每个车型一张图像

GET/api/{brand}/{model}/image

在不知道年份、车身款式或配置的情况下,返回车型的代表性图像 — 例如用于车型选择器。/api/{brand}/{model}/modelimage 是相同的端点。

车辆是根据固定规则选择的,因此同一型号总是返回同一辆车:最新年份、该年份最常见的车身款式、基础配置(否则为第一个)、以及 front_left 视图(否则为您的计划允许的第一个外观视图)。使用 year、variant 或 view 进行筛选。

响应内容与所选车辆的单视图图像响应完全相同 — id、year、variant 和 trim 会告诉您具体是哪一辆,这样您就可以继续使用目录或 /api/id/{id}。所有图像选项(format、width、color 等)均适用,并且它的计数方式与单张图像相同。

路径参数

名称类型描述
brand 必需 字符串 品牌名称 — 请参阅 /api/brands。
model 必需 字符串 车型名称 — 请参阅 /api/{brand}。

查询参数

名称类型描述
year 整数 使用此年份的生成结果,而不是最新年份(与目录相同的规则)。
variant 字符串 仅此车身款式(如 `Kombi` / `Estate` 等同名称在目录中有效)。
view 字符串 除了 `front_left` 之外的其他视角 — 请参阅 /api/views。
version 字符串 仅从一个版本获取结果:`v1` = 标准图像,`v2` = API v2 附加部分(无回退到标准图像)。没有它:您的密钥允许的所有内容。您的密钥不允许 → `403`。v1v2