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` 必需	字符串	场景（请参阅生活场景：场景）。

请求

curl "https://api.vehicleimagery.com/api/bmw/m4/2024/coupe/base/lifestyle/scene" \
  -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 · 请求路径无数据。

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