图像
解析签名图像 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 目录颜色加工作室阴影。
路径参数
| 名称 | 类型 | 描述 |
|---|---|---|
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`。与所有其他选项结合使用。 |
shadow | 字符串 | 交付时渲染的工作室地面阴影，适用于每个外观视图。使用 `mirroring=true` 时，这控制的是底盘阴影。truefalse |
transparency | 字符串 | 透明剪切背景 — 每个外观视图都可用（与PNG/WebP一起使用）。 truefalse |
ground | 字符串 | 将车辆放在地面上（需要透明变体）。 true |
mirroring | 字符串 | 反光地面。`true` = 带底盘阴影，`clean` = 仅反光。需要透明变体。trueclean |
