API v2 附加组件
生活方式:解析图像
GET/api/{brand}/{model}/{year}/{variant}/{trim}/lifestyle/{scene}/{image}
API v2附加组件 — 具有v2访问权限的密钥。 一张带有签名 image_url 的生活方式图像。生活方式图像是完整的场景:它们总是填满整个画面(fit=cover),background 不适用(错误提示 B32)。涂装(color)、lights、size、ratio 和 format 与其他地方的功能相同。
路径参数
| 名称 | 类型 | 描述 |
|---|---|---|
brand 必需 | 字符串 | 品牌名称(附加车辆的更新目录命名) |
model 必需 | 字符串 | 车型名称 |
year 必需 | 整数 | 车型年份(四位数)。如果缺少精确年份,则使用最近可用的车型(错误提示 `Y01`) |
variant 必需 | 字符串 | 车身变体 |
trim 必需 | 字符串 | 修剪级别 |
scene 必需 | 字符串 | 场景。 |
image 必需 | 字符串 | 场景图像(见 *生活方式:场景图像*) |
查询参数
| 名称 | 类型 | 描述 |
|---|---|---|
format | 字符串 | 输出格式。pngwebpjpegavifauto |
ratio | 字符串 | 裁剪填充的纵横比。 1:14:33:216:916:102:121:95:43:44:52:39:16 |
color | 字符串 | 涂装:目录颜色名称或 6 位十六进制。 |
lights | 字符串 | **API v2 插件:** 头灯开或关(默认 `off`)。图像不可用 → `off` + 错误提示 `L26`。onoff |
windows | 字符串 | **API v2 插件:** `see_through` = 玻璃,如图所示(默认),`dark` = 隐私玻璃,无法看透。不可用 → 错误提示 `W28`。see_throughdark |
plate | 字符串 | **API v2 插件:** 车牌 — `none` = 如图所示(默认),`blank` = 空白车牌,`logo` = 车牌上显示您的标志(在您的密钥中设置;缺失 → 空白 + 错误提示 `N30`)。noneblanklogo |
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 |

