API v2 附加组件

生活方式：场景图像

GET/api/{brand}/{model}/{year}/{variant}/{trim}/lifestyle/{scene}

API v2附加组件 — 具有v2访问权限的密钥。 一组生活方式场景的图像（views）。使用 *Lifestyle: resolve an image* 解析一张图像。

路径参数

名称	类型	描述
`brand` 必需	字符串	品牌名称（附加车辆的更新目录命名）
`model` 必需	字符串	车型名称
`year` 必需	整数	车型年份（四位数）。如果缺少精确年份，则使用最近可用的车型（错误提示 `Y01`）
`variant` 必需	字符串	车身变体
`trim` 必需	字符串	修剪级别
`scene` 必需	字符串	场景（请参阅生活场景：场景）。

查询参数

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

请求

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

200 · 场景的图像。

[
  {
    "id": 900000003,
    "brand": "Audi",
    "model": "Q9",
    "year": 2026,
    "variant": "SUV",
    "trim": "Default",
    "group": "lifestyle",
    "scene": "garden_pavilion",
    "resolution": "default",
    "format": "png",
    "views": {
      "front_left_glass_wall": true,
      "front_left_leaves": true,
      "front_right_leaves": true,
      "front_rocks": true
    }
  }
]

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

{
  "error": "Invalid API key"
}

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

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

404 · 请求路径无数据。对于车辆路径，`not_found` 表示不存在的级别，`alternatives` 列出了该级别存在的内容。

{
  "error": "Model '9 series' not found for 'BMW' — check /api/BMW for valid models.",
  "code": "model_not_found",
  "not_found": "model",
  "alternatives": {
    "models": [
      "1 series",
      "2 series",
      "3 series",
      "4 series",
      "5 series"
    ]
  }
}