Adicional da API v2

Grupo de estúdio: liste suas imagens

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

API v2 add-on — chaves com acesso v2. As imagens de um grupo de estúdio. hero representa qualquer grupo de estúdio do carro. Quais um carro tem está em groups no endpoint de trim.

Grupo	O que mostra	Nomes das imagens (exemplo de carro)
`hero`	Fotos heroicas: vistas em três quartos, algumas tiradas do nível do chão	`front_left`, `front_left_ground`, `front_right`, `front_right_ground`, `left_ground`, `rear_left`, `rear_right`, `right_ground` (8)
`steered`	Rodas dianteiras viradas, de três alturas de câmera	`front_left`, `front_left_eye`, `front_left_high`, `front_left_low`, `front_right`, … (8)
`extra`	Mais ângulos: cada lado e canto de três alturas de câmera, cantos também a 30° e 45°	`front_eye`, `front_high`, `front_low`, `front_left_30`, `front_left_30_eye`, `front_left_45_high`, `rear_right_45_low`, `left_eye` … (56)
`drone`	De cima: ângulos inclinados, vistas íngremes e diretamente de cima	`front_left`, `front_right`, `front_steep`, `rear_left`, `rear_right`, `rear_steep`, `top` (7)

Nomes das imagens são construídos a partir do lado (front, front_left, left, rear_right …) mais sufixos: _eye = nível dos olhos, _high = câmera acima, _low = câmera baixa, _ground = ao nível do chão, _30 / _45 = visão do canto a 30° / 45°, _steep = inclinado de cima, top = de cima para baixo. A lista exata por carro está sempre em views deste endpoint.

Escolha uma imagem de views e resolva-a com *Resolver uma imagem de grupo de estúdio*, por exemplo, GET /api/Audi/Q9/2026/SUV/Default/hero/front_left

Parâmetros de caminho

Nome	Tipo	Descrição
`brand` obrigatório	string	Nome da marca (nomenclatura de catálogo atualizada para carros adicionais).
`model` obrigatório	string	Nome do modelo
`year` obrigatório	integer.	Ano do modelo (4 dígitos). Se o ano exato estiver ausente, a geração mais próxima disponível é usada (nota de erro `Y01`).
`variant` obrigatório	string	Variante de carroceria.
`trim` obrigatório	string	Nível de acabamento.

Parâmetros de consulta

Nome	Tipo	Descrição
`version`	string	Resultados de apenas uma versão: `v1` = imagens padrão, `v2` = add-on da API v2 (sem recair nas imagens padrão). Sem ele: tudo o que sua chave permite. Não permitido para sua chave → `403`. `v1v2`

Solicitar

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

200 · Imagens do grupo.

[
  {
    "id": 900000003,
    "brand": "Audi",
    "model": "Q9",
    "year": 2026,
    "variant": "SUV",
    "trim": "Default",
    "group": "hero",
    "resolution": "default",
    "format": "png",
    "views": {
      "front_left": true,
      "front_left_ground": true,
      "front_right": true,
      "front_right_ground": true,
      "rear_left": true,
      "rear_right": true
    }
  }
]

401 · `x-api-key` ausente ou inválida.

{
  "error": "Invalid API key"
}

403 · Restrição de plano (recurso, formato ou marca não permitido) ou solicitação bloqueada.

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

404 · Sem dados para o caminho solicitado. Para um caminho de carro, `not_found` nomeia o nível que não existe e `alternatives` lista o que existe lá em vez disso.

{
  "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"
    ]
  }
}