图像
每个车型一张图像
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 |

