变体的修剪

GET/api/{brand}/{model}/{year}/{variant}

该变体的修剪级别 — 在选择视图并解析图像之前的最后一步目录步骤

路径参数

名称	类型	描述
`brand` 必需	字符串	品牌。
`model` 必需	字符串	车型
`year` 必需	整数	车型年份（四位数）。如果缺少精确年份，则使用最近可用的车型（错误提示 `Y01`）
`variant` 必需	字符串	车身变体

查询参数

名称	类型	描述
`version`	字符串	仅从一个版本获取结果：`v1` = 标准图像，`v2` = API v2 附加部分（无回退到标准图像）。没有它：您的密钥允许的所有内容。您的密钥不允许 → `403`。`v1v2`

请求

curl "https://api.vehicleimagery.com/api/bmw/m4/2024/coupe?version=v1" \
  -H "x-api-key: YOUR_API_KEY"

200 · 车型配置。

[
  {
    "brand": "Abarth",
    "model": "124_Spider_Abarth",
    "year": 2016,
    "variant": "Basis",
    "resolution": "default",
    "format": "png",
    "trims": [
      "base"
    ]
  }
]

401 · 缺失或无效的 `x-api-key`。

{
  "error": "Invalid API key"
}

403 · 计划限制（功能、格式或品牌不允许）或被阻止的请求。

{
  "error": "Mirroring is not allowed by your plan."
}

404 · 请求路径无数据。

{
  "error": "Brand 'Xyz' not found — check /api/brands for valid brands."
}