Des questions, des réponses

Elle transforme la description d'un véhicule en une image de studio de qualité photographique. Vous envoyez une marque, un modèle, une année, une variante et une finition, ou bien un VIN ou une plaque, et vous récupérez une URL d'image signée à placer directement dans une balise img. Pas de séance photo, pas de banque d'images, pas de retouche.

Une clé d'API dans un en-tête x-api-key, et rien d'autre. Tout le catalogue est un chemin d'URL, vous pouvez donc l'explorer avec curl avant d'écrire la moindre ligne de code. La documentation commence par une requête qui fonctionne.

GET /api/search?q=vw+golf compare du texte libre à toutes les marques et tous les modèles, et pardonne les surnoms, les fautes de frappe et les espacements inhabituels. La réponse contient des chemins de catalogue que vous pouvez continuer à parcourir. Une année dans la requête ne donnera aucun résultat, les années se trouvent un niveau plus bas.

Oui. La page d'exemples est une place de marché de démonstration en direct : chaque image y est récupérée depuis l'API pendant que vous naviguez, et vous pouvez vous-même changer l'angle, repeindre la voiture et modifier le fond. Si vous voulez le voir sur vos propres véhicules, envoyez-nous-en quelques-uns et nous revenons avec les images, en général le jour ouvré même.

Il existe un paquet sur npm et un serveur MCP pour les agents IA. Aucun des deux n'est obligatoire. C'est un endpoint HTTPS qui renvoie une URL d'image, et toute plateforme sait déjà gérer cela.

La plupart des équipes ont une image sur une page le jour même où elles reçoivent leur clé, parce que l'intégration est une URL. Passer de là à la production est en général une question d'endroit où mettre en cache, pas de quantité de code à écrire.

100 marques et plus de 65 000 modèles, années courantes et passées. GET /api/brands renvoie à tout moment la liste réelle pour votre clé, vous n'avez donc jamais à croire un chiffre affiché sur une page marketing. Voir la couverture.

Les générations passées sont couvertes, et cela compte plus qu'on ne croit : les annonces d'occasion, les catalogues de remarketing et les guides d'achat portent surtout sur des voitures qui ont quitté les showrooms il y a des années. GET /api/{brand}/{model} liste tous les millésimes disponibles pour ce modèle.

Non. Fourgons, utilitaires, pick-up et motos sont rendus avec le même aspect studio, une page de flotte mixte se lit donc toujours comme un seul catalogue. C'est exactement pour cela qu'il y a une moto dans la grille de la page d'exemples.

L'API le dit au lieu de deviner, vous obtenez donc un embranchement dans votre code plutôt qu'une mauvaise voiture sur une page. Lorsqu'un millésime demandé n'existe pas, elle bascule sur la génération disponible la plus proche et le signale dans errornotes.

En continu, à mesure que les données constructeur deviennent disponibles. Pour le leasing et les configurateurs, c'est le point décisif : un modèle existe généralement dans le catalogue des mois avant que le premier ne sorte d'usine, c'est-à-dire au moment où la page d'offre en a besoin.

Oui, GET /api/getall renvoie en une seule réponse toutes les configurations accessibles à votre clé. Elle est volumineuse à dessein et prévue pour une synchronisation nocturne, pas pour un chargement de page. Voir l'endpoint.

Oui, les clés peuvent être restreintes, et GET /api/me signale toute restriction dans blocked_brands et year_range. Pratique lorsqu'un contrat de concession ne couvre qu'une partie du marché.

Neuf vues : huit angles extérieurs (face, arrière, les deux côtés et les quatre trois-quarts) plus des prises intérieures comme la console centrale lorsque le véhicule en dispose. Chacune est une requête distincte sur la même configuration, dans un cadrage studio identique. Les voir toutes.

Oui, et le changement repeint la vraie prise de vue studio, un métallisé se lit donc toujours comme un métallisé. Cinq teintes maison sont disponibles sur tous les véhicules, les teintes catalogue de chaque marque s'y ajoutent, et il y a également des coverings 3M. GET /api/{...}/colors liste ce que propose une voiture précise. Voir les teintes.

Quatre options, chacune un seul paramètre : shadow=true pour une ombre portée de studio, ground=true pour une ombre de contact qui pose la voiture sur une surface, mirroring=true pour un sol de showroom réfléchissant et transparency=true pour un détourage net que vous pouvez poser sur n'importe quoi. Voir la différence.

PNG, WebP, JPEG et AVIF, en largeurs de 200, 400, 800, 1200, 1600 ou 2000 pixels, avec une qualité entre 40 et 100 (82 par défaut). Il existe aussi des préréglages nommés, de thumb (320 px) à full (2000 px), si vous préférez ne pas choisir de chiffres.

Nativement en 3:2. Demandez un autre ratio et l'image est complétée plutôt que recadrée, rien n'est donc jamais coupé sur la voiture : 1:1, 4:3, 16:9, 16:10, 2:1, 21:9 et leurs équivalents en portrait sont tous disponibles. C'est pour cela qu'une vignette carrée et une bannière panoramique peuvent utiliser le même véhicule sans graphiste entre les deux.

Oui, transparency=true renvoie un détourage avec un vrai canal alpha. À savoir : la transparence impose le PNG, et un PNG pèse plusieurs fois plus lourd que la même voiture en WebP. Utilisez-le là où vous avez vraiment besoin de l'alpha, et WebP partout ailleurs.

Pas sur une offre normale. GET /api/me vous dit exactement ce que votre clé autorise, y compris si un filigrane est imposé.

C'est tout l'intérêt de générer plutôt que de collecter. Chaque véhicule utilise la même position de caméra, la même distance et la même lumière, un tableau mixte compare donc des voitures et non des photographes. C'est la raison pour laquelle les équipes flotte et leasing finissent par arriver ici.

C'est un chemin : /api/{brand}/{model}/{year}/{variant}/{trim}/{view}. Un GET sur n'importe quel préfixe plus court liste le niveau suivant, tout l'arbre se découvre donc en le parcourant. Aucun schéma à apprendre avant la première requête.

Oui. Un VIN fonctionne partout ; la recherche par plaque dépend du marché. La marque, le modèle, l'année et la finition se résolvent aussi, et c'est souvent tout ce que contient un formulaire d'annonce ou une déclaration de flotte. Plus sur la résolution.

Chaque configuration possède un identifiant permanent. GET /api/id/{id} renvoie toutes les vues disponibles, GET /api/id/{id}/{view} une seule. Les identifiants survivent aux mises à jour de catalogue et aux renommages, vous pouvez donc les enregistrer sans risque dans votre propre base de données.

Oui, et la plupart des intégrations le font. Copiez l'image dans votre propre stockage et servez-la de là, pour qu'un chargement de page ne dépende jamais d'un appel chez nous. Les URL signées restent valides sept jours, largement de quoi les récupérer et les stocker.

Elle retombe sur la valeur valide la plus proche et vous indique ce qu'elle a fait dans errornotes, au lieu d'échouer. Il existe 17 codes, chacun avec une signification en langage clair, pour que vous puissiez les journaliser ou les ignorer en connaissance de cause. Voir les codes.

En général bien moins qu'il n'y paraît. Les configurations identiques donnent le même rendu : quarante fourgons identiques sortis de flotte, c'est une image réutilisée. Mettez en cache de votre côté et un écran qui montre les mêmes vingt véhicules à chaque visiteur coûte vingt requêtes au total, pas vingt par visiteur.

C'est une simple URL HTTPS, votre chargeur d'images et son cache disque s'en accommodent sans changement, en natif comme dans une webview. Demandez la largeur réellement utilisée par la mise en page plutôt que de réduire une image d'impression sur l'appareil. Plus pour les équipes mobiles.

Non, et c'est délibéré : le catalogue se consulte, il ne se pousse pas. Synchronisez-le quand vous voulez avec GET /api/getall, ou lisez le changelog pour voir ce qui est sorti. Rien n'exige d'endpoint de votre côté.

Elles sont servies depuis un cache mondial en périphérie, le premier octet vient donc d'un point proche du visiteur et non d'un serveur d'origine. Une variante est générée une fois puis servie depuis le cache.

Oui. La page d'état affiche la disponibilité et les temps de réponse en direct, mesurés hors de notre propre infrastructure. GET /api/status est un contrôle de disponibilité lisible par machine pour votre propre supervision.

Les variantes en cache n'atteignent pas l'API, ce qui est le cas normal sur une page de catalogue où chaque visiteur voit les mêmes véhicules. C'est aussi pourquoi un jour de lancement ou de campagne se comporte comme un mardi ordinaire.

Rien, si vous avez suivi le schéma habituel : copiez l'image une fois dans votre propre stockage et servez-la de là. Votre page dépend alors de votre CDN, pas du nôtre. C'est la chose la plus utile à construire tôt.

Elles sont générées à partir de données véhicules que nous licencions. Ce ne sont pas des photographies et elles ne sont pas récupérées sur des sites de concessionnaires ni dans des dossiers de presse. C'est la raison pour laquelle nous pouvons mettre par écrit les usages autorisés, ce qui est en général la question qui ouvre la discussion avec un service juridique.

Oui. Annonces, applications, campagnes, impression et documents clients sont couverts, sans mention de crédit et sans filigrane. Dites-nous quels documents vous produisez et cela figurera explicitement dans la licence.

Oui, et pour les assureurs et les financeurs c'est justement l'objectif : devis, conditions particulières, contrats et correspondance sinistre. Voir assurance et financement pour la mise en place habituelle.

Non. Il n'y a personne sur l'image et aucun lieu identifiable, ce qui supprime toute une catégorie de démarches de droits que la photographie implique.

Des identifiants de véhicule, rien d'autre. Un VIN peut être transmis sans le contrat, la commande ou le client auquel il se rapporte, rien de personnel n'a donc besoin de quitter vos systèmes.

Elle montre le modèle, la finition et la couleur d'usine enregistrée, c'est-à-dire l'usage qu'on a toujours fait des visuels constructeur. Ce n'est pas la photo d'un exemplaire précis et cela ne doit pas être présenté comme tel. La plupart des plateformes l'affichent comme image représentative de cette configuration et gardent les vraies photos pour la galerie.

Les afficher à vos utilisateurs est couvert par défaut. Leur permettre de télécharger ou de rediffuser les fichiers est un droit différent : dites-nous si vous en avez besoin et cela figurera explicitement dans la licence plutôt que de rester flou.

Par configurations distinctes, pas par pages vues, et c'est pour cela que la courbe de coût s'aplatit exactement là où se trouve le volume : un modèle publié mille fois, ce n'est pas mille rendus. Voir les offres.

Un mix de modèles approximatif et le nombre de véhicules que vous publiez ou servez par mois. Cela suffit. Pour un loueur c'est la liste des catégories, pour un financeur le mix de dérivés, pour un portail le nombre mensuel d'annonces.

Non. Un courtier avec une poignée de propositions par semaine et un portail avec des millions d'annonces reçoivent les mêmes images et les mêmes options.

GET /api/me y répond en un seul appel : fonctions activées, formats autorisés, résolutions, ratios, vues, couleurs et marques, plus les éventuelles restrictions et la durée de validité des URL signées. Voir l'endpoint.

Non. Une configuration est rendue une fois ; chaque requête ultérieure sur la même combinaison est servie depuis le cache. C'est pour cela qu'un portail qui publie mille fois le même modèle ne paie pas mille fois.

Écrivez-nous ou réservez un court appel. Les réponses arrivent le plus souvent le jour ouvré même, et elles viennent de ceux qui construisent tout ça, pas d'une file de tickets.

Envoyez-nous la marque, le modèle et l'année. Ajouter un modèle est un travail normal pour nous, pas une faveur, et c'est souvent le moyen le plus rapide de savoir si un manque est un problème de données ou une simple différence de nomenclature.

Demandez. Un angle précis, un traitement de fond ou un format de livraison absent de la liste mérite une discussion ; une partie de ce qui est standard aujourd'hui a commencé parce qu'un client l'a demandé.