参考

所有视图名称

GET/api/views

目录中每个视图名称都标记为 flat (前/后/左/右)，three_quarter (前左…后右) 或 other (内饰)。每辆车的可用性在配置 /features 或 /views 中。

API v2 插件： 使用插件 addon.groups 列出组别 — hero、steered、extra、drone（类型为 studio）、360（spin）和 lifestyle（scene）。

请求

curl "https://api.vehicleimagery.com/api/views" \
  -H "x-api-key: YOUR_API_KEY"

200 · 视图。

{
  "views": [
    {
      "view": "front",
      "type": "flat"
    },
    {
      "view": "front_left",
      "type": "three_quarter"
    },
    {
      "view": "dashboard",
      "type": "other"
    }
  ],
  "note": "Per-car availability is in /features.",
  "addon": {
    "groups": [
      {
        "group": "hero",
        "type": "studio",
        "description": "Hero shots: three-quarter views, some from ground level (_ground)"
      },
      {
        "group": "steered",
        "type": "studio",
        "description": "Front wheels turned, from three camera heights (_eye, _high, _low)"
      },
      {
        "group": "extra",
        "type": "studio",
        "description": "More angles: every side and corner from three camera heights (_eye, _high, _low), corners also at 30° and 45° (_30, _45)"
      },
      {
        "group": "drone",
        "type": "studio",
        "description": "From above: angled drone shots, steep views (_steep) and straight from the top (top)"
      },
      {
        "group": "360",
        "type": "spin",
        "description": "360° spins in rings (eye_level, low, high), every frame with its own image_url"
      },
      {
        "group": "lifestyle",
        "type": "scene",
        "description": "The car in real-looking settings, scenes with several images"
      }
    ]
  }
}

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