API v2 附加组件
解析摄影棚组图像
GET/api/{brand}/{model}/{year}/{variant}/{trim}/{group}/{image}
API v2 附加组件 — 具有 v2 访问权限的密钥。 一张工作室组合图：hero (主打图，部分从地面拍摄)，steered (转向前轮)，extra (更多角度从三个摄像机高度拍摄，角落也有 30° 和 45°)，drone (俯拍)。这些组合及其图片名称在 *工作室组合：列出其图片* 中有说明。
GET …/{trim} 列出车辆的组别（groups），GET …/{trim}/{group} 列出一个组别的图像（views）。然后在此处解析一个图像。接受所有图像选项，包括插件选项（lights，background，十六进制 color，windows，plate，fit，size，hotspots）。
示例： GET /api/Audi/Q9/2026/SUV/Default/hero → { group: "hero", views: { front_left: true, front_left_ground: true, … } }，然后 GET /api/Audi/Q9/2026/SUV/Default/hero/front_left?color=c8102e&size=1080p&format=webp。
路径参数
| 名称 | 类型 | 描述 |
|---|---|---|
brand 必需 | 字符串 | 品牌名称（附加车辆的更新目录命名） |
model 必需 | 字符串 | 车型名称 |
year 必需 | 整数 | 车型年份（四位数）。如果缺少精确年份，则使用最近可用的车型（错误提示 `Y01`） |
variant 必需 | 字符串 | 车身变体 |
trim 必需 | 字符串 | 修剪级别 |
group 必需 | 字符串 | 摄影棚组：英雄、转向、额外、无人机（见修剪端点的 `groups`） |
image 必需 | 字符串 | 车组图像（见车组的 `views`） |
查询参数
| 名称 | 类型 | 描述 |
|---|---|---|
format | 字符串 | 输出格式。pngwebpjpegavifauto |
ratio | 字符串 | 纵横比。 1:14:33:216:916:102:121:95:43:44:52:39:16 |
width | 整数 | 像素宽度。 |
color | 字符串 | 涂装：目录颜色名称或 6 位十六进制。 |
shadow | 字符串 | 摄影棚阴影。truefalse |
lights | 字符串 | **API v2 插件：** 头灯开或关（默认 `off`）。图像不可用 → `off` + 错误提示 `L26`。onoff |
background | 字符串 | **API v2 插件：** `white`（默认），`transparent`，或类似 `f4f4f4` 的六位十六进制颜色。仅适用于工作室图像（生活方式 → 错误提示 `B32`）。 |
windows | 字符串 | **API v2 插件：** `see_through` = 玻璃，如图所示（默认），`dark` = 隐私玻璃，无法看透。不可用 → 错误提示 `W28`。see_throughdark |
plate | 字符串 | **API v2 插件：** 车牌 — `none` = 如图所示（默认），`blank` = 空白车牌，`logo` = 车牌上显示您的标志（在您的密钥中设置；缺失 → 空白 + 错误提示 `N30`）。noneblanklogo |
fit | 字符串 | **API v2 插件：** 车辆如何填充 `ratio` / `size` 框 — `contain` 填充（默认），`cover` 裁剪。生活方式图像总是覆盖。containcover |
size | 字符串 | **API v2 插件：**最长边 — `2k` 2560 像素，`1080p` 1920 像素，`720p` 1280 像素，`540p` 960 像素，`360p` 640 像素，`thumb` 320 像素。`width` / `height` 优先于 `size`。2k1080p720p540p360pthumb |
hotspots | 字符串 | **API v2 插件：** 在响应中添加 `hotspots` — 图像中的兴趣点（轮毂、前灯等）以 0–1 的分数表示，例如用于交互式查看器。true |
