API v2 附加组件

生活方式：场景

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

API v2附加功能 — 具有v2访问权限的密钥。 汽车的生活场景 — 汽车放置在真实的环境中 — 以及它们的图像数量。

路径参数

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

请求

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

200 · 场景。

[
  {
    "id": 900000003,
    "brand": "Audi",
    "model": "Q9",
    "year": 2026,
    "variant": "SUV",
    "trim": "Default",
    "group": "lifestyle",
    "scenes": [
      {
        "scene": "garden_pavilion",
        "images": 14
      }
    ]
  }
]

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."
}