Adicional da API v2
Resolver uma imagem de grupo de estúdio
API v2 add-on — chaves com acesso v2. Uma imagem de um grupo de estúdio: hero (fotos principais, algumas do nível do chão), steered (rodas dianteiras viradas), extra (mais ângulos de três alturas de câmera, cantos também a 30° e 45°), drone (de cima). Os grupos e os nomes das imagens são explicados em *Grupo de estúdio: lista suas imagens*.
GET …/{trim} lista os grupos que um carro possui (groups), GET …/{trim}/{group} lista as imagens de um grupo (views). Em seguida, resolva uma aqui. Aceita todas as opções de imagem, incluindo as opções do add-on (lights, background, cor hex color, windows, plate, fit, size, hotspots).
Exemplo: GET /api/Audi/Q9/2026/SUV/Default/hero → { group: "hero", views: { front_left: true, front_left_ground: true, … } }, depois GET /api/Audi/Q9/2026/SUV/Default/hero/front_left?color=c8102e&size=1080p&format=webp.
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. |
group obrigatório | string | Grupo de estúdio: hero, dirigido, extra, drone (veja `groups` no endpoint de trim). |
image obrigatório | string | Imagem do grupo (veja `views` do grupo). |
Parâmetros de consulta
| Nome | Tipo | Descrição |
|---|---|---|
format | string | Formato de entrega. pngwebpjpegavifauto |
ratio | string | Proporção de aspecto. 1:14:33:216:916:102:121:95:43:44:52:39:16 |
width | integer. | Largura em px. |
color | string | Tinta: nome da cor do catálogo ou hexadecimal de 6 dígitos. |
shadow | string | Sombra do estúdio no chão. truefalse |
lights | string | **API v2 add-on:** faróis ligados ou desligados (padrão `off`). Não disponível para uma imagem → `off` + erro `L26`. onoff |
background | string | **API v2 add-on:** `white` (padrão), `transparent`, ou uma cor hexadecimal de 6 dígitos como `f4f4f4`. Apenas imagens de estúdio (lifestyle → erro `B32`). |
windows | string | **API v2 add-on:** `see_through` = vidro como na imagem (padrão), `dark` = vidro privativo que não se vê através. Não disponível → erro `W28`. see_throughdark |
plate | string | **API v2 add-on:** placa de licença — `none` = como na imagem (padrão), `blank` = placa vazia, `logo` = seu logo na placa (configurado na sua chave; ausente → branco + erro `N30`). noneblanklogo |
fit | string | **API v2 add-on:** como o carro preenche uma caixa `ratio` / `size` — `contain` preenche (padrão), `cover` recorta. Imagens lifestyle sempre cobrem. containcover |
size | string | **Adicionar ao API v2:** lado mais longo: `2k` 2560 px, `1080p` 1920 px, `720p` 1280 px, `540p` 960 px, `360p` 640 px, `thumb` 320 px. `width` / `height` prevalecem sobre `size`. 2k1080p720p540p360pthumb |
hotspots | string | **API v2 add-on:** adicione `hotspots` à resposta — pontos de interesse (rodas, faróis ...) como frações 0–1 da imagem, por exemplo, para visualizadores interativos. true |
