Perguntas, respondidas

Ela transforma a descrição de um veículo numa imagem de estúdio com qualidade fotográfica. Você envia marca, modelo, ano, versão e acabamento, ou um chassi ou uma placa, e recebe uma URL de imagem assinada que pode colocar direto numa tag img. Sem sessão de fotos, sem banco de imagens, sem retoque.

Uma chave de API num cabeçalho x-api-key, e nada mais. Todo o catálogo é um caminho de URL, então você pode explorá-lo com curl antes de escrever qualquer linha de código. A documentação começa com uma requisição que funciona.

GET /api/search?q=vw+golf compara texto livre com todas as marcas e modelos e perdoa apelidos, erros de escrita e espaçamentos estranhos. Responde com caminhos de catálogo que você pode continuar percorrendo. Se colocar um ano na consulta não haverá correspondência, os anos ficam um nível abaixo.

Sim. A página de exemplos é um marketplace de demonstração ao vivo: cada imagem ali é obtida da API enquanto você navega, e você mesmo pode trocar o ângulo, repintar o carro e mudar o fundo. Se quiser ver nos seus próprios veículos, envie alguns e voltamos com as imagens, normalmente no mesmo dia útil.

Existe um pacote no npm e um servidor MCP para agentes de IA. Nenhum dos dois é obrigatório. É um endpoint HTTPS que devolve uma URL de imagem, e com isso qualquer plataforma já sabe lidar.

A maioria dos times tem uma imagem numa página no mesmo dia em que recebe a chave, porque a integração é uma URL. Ir dali até produção costuma ser uma questão de onde colocar o cache, não de quanto código escrever.

100 marcas e mais de 65.000 modelos, de anos atuais e anteriores. GET /api/brands devolve a lista real da sua chave a qualquer momento, portanto nunca precisa acreditar num número numa página de marketing. Ver a cobertura.

Gerações anteriores estão cobertas, e isso importa mais do que se imagina: anúncios de usados, catálogos de remarketing e guias de compra tratam sobretudo de carros que saíram dos showrooms há anos. GET /api/{brand}/{model} lista todos os anos-modelo disponíveis para aquele modelo.

Não. Vans, veículos comerciais, picapes e motos são renderizados com o mesmo visual de estúdio, então uma página de frota mista continua se lendo como um só catálogo. É exatamente por isso que há uma moto na grade da página de exemplos.

A API avisa em vez de adivinhar, então você tem uma ramificação no seu código em vez de um carro errado numa página. Quando um ano-modelo pedido não existe, ela ajusta para a geração disponível mais próxima e informa isso em errornotes.

De forma contínua, à medida que os dados do fabricante ficam disponíveis. Para leasing e configuradores esse é o ponto decisivo: um modelo costuma existir no catálogo meses antes de o primeiro ser fabricado, que é exatamente quando a página de oferta precisa dele.

Sim, GET /api/getall despeja numa única resposta todas as configurações disponíveis para a sua chave. Ela é grande de propósito e feita para uma sincronização noturna, não para o carregamento de uma página. Ver o endpoint.

Sim, as chaves podem ser restringidas, e GET /api/me informa qualquer restrição em blocked_brands e year_range. Útil quando um contrato de concessão cobre apenas parte do mercado.

Nove vistas: oito ângulos externos (frente, traseira, ambas as laterais e as quatro de três quartos) mais tomadas internas como o console central quando o veículo as tem. Cada uma é uma requisição separada sobre a mesma configuração, no mesmo enquadramento de estúdio. Ver todas.

Sim, e a mudança repinta a tomada de estúdio real, então um metálico continua se lendo como metálico. Cinco cores próprias estão disponíveis em todos os veículos, as cores de catálogo de cada marca vêm por cima, e também há envelopamentos 3M. GET /api/{...}/colors lista o que um carro específico oferece. Ver as cores.

Quatro opções, cada uma um único parâmetro: shadow=true para uma sombra projetada de estúdio, ground=true para uma sombra de contato que apoia o carro numa superfície, mirroring=true para um piso de showroom reflexivo e transparency=true para um recorte limpo que você pode colocar sobre qualquer coisa. Veja a diferença.

PNG, WebP, JPEG e AVIF, em larguras de 200, 400, 800, 1200, 1600 ou 2000 pixels, com qualidade entre 40 e 100 (82 por padrão). Há também predefinições nomeadas, de thumb (320 px) a full (2000 px), se preferir não escolher números.

Nativamente em 3:2. Peça outra proporção e a imagem é preenchida em vez de recortada, então nada do carro é cortado: 1:1, 4:3, 16:9, 16:10, 2:1, 21:9 e os equivalentes em retrato estão todos disponíveis. É por isso que um card quadrado e um banner panorâmico podem usar o mesmo veículo sem um designer no meio.

Sim, transparency=true devolve um recorte com canal alfa de verdade. Vale saber: a transparência força PNG, e um PNG pesa várias vezes mais que o mesmo carro em WebP. Use onde você realmente precisa do alfa e WebP em todo o resto.

Num plano normal, não. GET /api/me diz exatamente o que a sua chave permite, inclusive se uma marca d'água é imposta.

É justamente para isso que se renderiza em vez de coletar. Cada veículo usa a mesma posição de câmera, a mesma distância e a mesma luz, então uma tabela mista compara carros em vez de comparar fotógrafos. É a razão pela qual times de frota e leasing acabam chegando aqui.

É um caminho: /api/{brand}/{model}/{year}/{variant}/{trim}/{view}. Um GET em qualquer prefixo mais curto lista o nível seguinte, então toda a árvore é descoberta percorrendo-a. Não há esquema a aprender antes da primeira requisição.

Sim. Um chassi funciona em todo lugar; a consulta por placa depende do mercado. Marca, modelo, ano e acabamento também resolvem, e muitas vezes é tudo o que um formulário de anúncio ou uma declaração de frota realmente contém. Mais sobre as buscas.

Cada configuração tem um id permanente. GET /api/id/{id} devolve todas as vistas disponíveis, GET /api/id/{id}/{view} apenas uma. Os ids sobrevivem a atualizações de catálogo e a renomeações, então podem ser gravados com segurança no seu próprio banco de dados.

Sim, e a maioria das integrações faz isso. Copie a imagem para o seu próprio armazenamento e sirva-a de lá, para que o carregamento de uma página nunca dependa de uma chamada até nós. As URLs assinadas continuam válidas por sete dias, tempo de sobra para baixar e guardar.

Ela recorre ao valor válido mais próximo e diz o que fez em errornotes, em vez de falhar. São 17 códigos, cada um com um significado em linguagem clara, para que você possa registrá-los ou ignorá-los conscientemente. Ver os códigos.

Normalmente bem menos do que parece. Configurações idênticas resolvem para o mesmo render, então quarenta vans iguais desmobilizadas são uma imagem reaproveitada. Faça cache do seu lado e uma tela que mostra os mesmos vinte veículos a cada visitante custa vinte requisições no total, não vinte por visitante.

É uma URL HTTPS comum, então o seu carregador de imagens e o cache em disco lidam com ela sem mudanças, tanto em nativo quanto numa webview. Peça a largura que o layout realmente usa em vez de reduzir no aparelho uma imagem feita para impressão. Mais para times de apps.

Não, e de propósito: o catálogo é consultado, não enviado. Sincronize quando quiser com GET /api/getall, ou leia o changelog para ver o que foi lançado. Nada exige um endpoint do seu lado.

Elas são servidas de um cache global na borda, então o primeiro byte vem de um ponto próximo do visitante e não de um servidor de origem. Uma variante é gerada uma vez e depois servida do cache.

Sim. A página de estado mostra disponibilidade e tempos de resposta ao vivo, medidos fora da nossa própria infraestrutura. GET /api/status é uma verificação de disponibilidade legível por máquina para o seu próprio monitoramento.

Variantes em cache nem chegam à API, o que é o caso normal numa página de catálogo onde cada visitante vê os mesmos veículos. É por isso que um dia de lançamento ou de campanha se comporta como uma terça-feira qualquer.

Nada, se você seguiu o padrão de sempre: copie a imagem uma vez para o seu próprio armazenamento e sirva-a de lá. A sua página passa a depender do seu CDN, não do nosso. É a coisa mais útil de construir cedo.

Elas são renderizadas a partir de dados de veículos que licenciamos. Não são fotografias e não são raspadas de sites de concessionárias nem de kits de imprensa. É por isso que conseguimos colocar os usos permitidos por escrito, que costuma ser a pergunta com que começa a conversa com um departamento jurídico.

Sim. Anúncios, aplicativos, campanhas, impressão e documentos de cliente estão cobertos, sem crédito de imagem e sem marca d'água. Diga quais documentos você produz e isso fica expressamente na licença.

Sim, e para seguradoras e financeiras esse costuma ser justamente o objetivo: orçamentos, condições da apólice, contratos e correspondência de sinistros. Veja seguros e financiamento para saber como isso costuma ser montado.

Não. Não há ninguém na imagem e nenhum local identificável, o que elimina toda uma categoria de liberação de direitos que a fotografia traz consigo.

Identificadores do veículo, nada mais. Um chassi pode ser enviado sem a apólice, o pedido ou o cliente a que pertence, então nada sobre uma pessoa precisa sair dos seus sistemas.

Ela mostra o modelo, o acabamento e a cor de fábrica registrada, que é como as imagens de fabricante sempre foram usadas. Não é uma fotografia de uma unidade específica e não deve ser apresentada como tal. A maioria das plataformas a exibe como imagem representativa daquela configuração e guarda as fotos reais para a galeria.

Exibi-las aos seus usuários já está coberto por padrão. Permitir que os usuários baixem ou redistribuam os arquivos é um direito diferente, então diga se você precisa disso e ficará expressamente na licença em vez de ficar em aberto.

Por configurações distintas, não por visualizações de página, e por isso a curva de custo se achata exatamente onde está o volume: um modelo que você anuncia mil vezes não são mil renders. Ver os planos.

Uma mistura aproximada de modelos e quantos veículos você anuncia ou serve por mês. Isso basta. Para uma locadora é a lista de categorias, para uma financeira a mistura de derivativos, para um portal o número mensal de anúncios.

Não. Um corretor com um punhado de propostas por semana e um portal com milhões de anúncios recebem as mesmas imagens e as mesmas opções.

GET /api/me responde a isso numa única chamada: recursos ativados, formatos permitidos, resoluções, proporções, vistas, cores e marcas, além de quaisquer restrições e a validade das URLs assinadas. Ver o endpoint.

Não. Uma configuração é renderizada uma vez; cada requisição posterior da mesma combinação é servida do cache. É por isso que um portal que anuncia o mesmo modelo mil vezes não paga mil vezes.

Escreva para nós ou marque uma conversa rápida. As respostas costumam chegar no mesmo dia útil, e vêm de quem constrói isto, não de uma fila de tickets.

Envie a marca, o modelo e o ano. Adicionar um modelo é trabalho normal para nós, não um favor, e costuma ser o jeito mais rápido de descobrir se uma lacuna é problema de dados ou uma divergência de nomenclatura.

Pergunte. Um ângulo específico, um tratamento de fundo ou um formato de entrega que não esteja na lista merece uma conversa; parte do que hoje é padrão começou porque um cliente pediu.