图像
解析签名图像 URL
GET/api/{brand}/{model}/{year}/{variant}/{trim}/{view}
核心端点。返回元数据加上一个签名的 image_url，您可以直接将其嵌入到 <img> 中。
將任何選項添加為查詢參數。如果車輛不支持或您的計劃不允許的任何內容，則回退到最接近的有效值，並在errornotes中報告（而不是失敗）。
示例
?format=webp&width=1200— WebP，宽 1200 像素。?ratio=16:9&format=jpeg— 填充为 16:9。?mirroring=true— 车辆在反光展厅地板上。?transparency=true&format=png— 透明背景剪切。?color=wine_red— 重新喷漆为 wine_red 房屋颜色。?color=Racing%20Red&shadow=true— Kia 目录颜色加工作室阴影。
API v2附加功能： 对于带有附加图像的汽车，以下额外选项适用（lights，background，十六进制 color，windows，plate，fit，size，hotspots），例如 ?color=c8102e&windows=dark&size=1080p。使用附加功能，{view} 也可以是工作室组（hero，steered，extra，drone）：它列出了该组的图像 — 请参阅 *API v2附加功能*。
路径参数
| 名称 | 类型 | 描述 |
|---|---|---|
brand 必需 | 字符串 | 品牌名称或别名（不区分大小写）。 |
model 必需 | 字符串 | 车型名称 |
year 必需 | 整数 | 车型年份（四位数）。如果缺少精确年份，则使用最近可用的车型（错误提示 `Y01`） |
variant 必需 | 字符串 | 车身变体 |
trim 必需 | 字符串 | 修剪级别 |
view 必需 | 字符串 | 视图名称 — 请参阅 /api/views（例如 front, front_left, rear） |
查询参数
| 名称 | 类型 | 描述 |
|---|---|---|
format | 字符串 | 交付格式。`auto` 选择 WebP。原始格式是 PNG。pngwebpjpegavifauto |
resolution | 字符串 | 尺寸/质量预设（由显式宽度/质量覆盖）。 defaultthumbsmallmediumlargefull |
ratio | 字符串 | 填充到宽高比。1:14:33:216:916:102:121:95:43:44:52:39:16 |
width | 整数 | 像素的显式宽度（对齐到宽度梯度） |
height | 整数 | 像素的显式高度 |
quality | 整数 | 编码器质量 (40–100) |
color | 字符串 | 按名称指定涂料颜色（不区分大小写；URL编码空格，例如 `Racing%20Red`）。车辆会根据需求重新喷漆 — 保持原厂色，反光和装饰不变。车辆的 `/colors` 列出其显示的颜色集（车厂颜色 + 其品牌颜色）；可以请求 `/api/colors` 中的任何活跃颜色。未知颜色 → 默认涂料 + 错误提示 `F04`。与所有其他选项结合使用。 **API v2 附加功能：** 也可以使用任何 6 位十六进制颜色代码，例如 `c8102e`。 |
shadow | 字符串 | 工作室地面阴影 — 在交付时生成，适用于每个外观视图。使用 `mirroring=true` 时，这控制的是底盘阴影。truefalse |
transparency | 字符串 | 透明剪切背景 — 每个外观视图都可用（与PNG/WebP一起使用）。 truefalse |
ground | 字符串 | 将车辆放在地面上（需要透明变体）。 true |
mirroring | 字符串 | 反光地面。`true` = 带底盘阴影，`clean` = 仅反光。需要透明变体。trueclean |
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 |
