API v2 附加组件
360°旋转：环的所有帧
GET/api/{brand}/{model}/{year}/{variant}/{trim}/360/{ring}
API v2 插件 — 具有 v2 访问权限的密钥。 一个环的每一帧按顺序排列，每一帧都有自己的签名 image_url 和角度 — 转动查看器需要所有这些。图像选项（格式、宽度、颜色、背景等）适用于每一帧，因此转动始终保持一致。
路径参数
| 名称 | 类型 | 描述 |
|---|---|---|
brand 必需 | 字符串 | 品牌名称（附加车辆的更新目录命名） |
model 必需 | 字符串 | 车型名称 |
year 必需 | 整数 | 车型年份（四位数）。如果缺少精确年份，则使用最近可用的车型（错误提示 `Y01`） |
variant 必需 | 字符串 | 车身变体 |
trim 必需 | 字符串 | 修剪级别 |
ring 必需 | 字符串 | 环：eye_level、低或高（请参阅 *360° 转动：环*）。 |
查询参数
| 名称 | 类型 | 描述 |
|---|---|---|
format | 字符串 | 输出格式。pngwebpjpegavifauto |
width | 整数 | 像素宽度。 |
color | 字符串 | 涂装：目录颜色名称、6位十六进制或 `<finish>_<hex>`（例如 `metallic_315fbf`）。 |
color_id | 整数 | 通过 `/api/colors` 使用颜色编号绘制颜色。当一个名称存在多次时使用它：编号是独一无二且永不改变的。优先于 `color`；`0` 是原始涂料。未知或已停用的编号 → 与未知名称相同（默认涂料 + 错误提示 `F04`）。 |
lights | 字符串 | **API v2 插件：**车灯开关。 **默认 `on`：**不带参数时，图像会带灯，无论图像中是否有灯；发送 `lights=off` 以获取无灯的图像。没有灯光变体的图像直接不带灯；带 `lights=on` 时也会携带错误提示 `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`)，`text` = 你自己的文本来自 `plate_text` (必须为你的密钥启用，见 `/api/me` 中的 `addon.plate_text`；否则错误提示 `O31`)。 noneblanklogotext |
plate_text | 字符串 | **API v2 插件：**`plate=text` 的文本 — 最多 10 个字符：字母、数字、空格和 `-` `.` `&`。按发送的内容写在车牌上 (保留大小写)，居中并尽可能大。缺失、过长或其他字符 → `400`。 |
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 |
version | 字符串 | 仅从一个版本获取结果：`v1` = 标准图像，`v2` = API v2 附加部分（无回退到标准图像）。没有它：您的密钥允许的所有内容。您的密钥不允许 → `403`。v1v2 |
