Une pièce neuve entre à l’assortiment sans image. Une annonce sans image vend mal, une image constructeur tierce est juridiquement délicate, et un studio propre ne se rentabilise qu’en volume. Pour les pièces d’occasion, cela ne s’applique pas — la pièce est sur le plan de travail et peut être photographiée.
Une exception explicite à la règle maison — ne produire que du justifié — s’applique ici : la génération sans image de référence est une prestation commandée. C’est précisément pourquoi le résultat doit être signalé comme généré et ne doit pas apparaître comme une photo de l’exemplaire stocké.
| Surface | Rôles |
|---|---|
| Hub | Commerce de pièces, Plateforme et marketplace, Commerce automobile |
Ce que ce cas suppose
- Une référence OE fiable. La génération suit la référence que vous donnez. Une mauvaise référence génère une mauvaise pièce, et cela n’apparaît que chez l’acheteur.
- La décision explicite de générer. Si vous avez une photo propre, le détourage est la bonne voie.
- Un marquage dans votre système. Une image générée doit rester identifiable comme telle, même après trois systèmes.
- De la patience pour un travail. La génération est asynchrone ; l’appel renvoie un
jobIdet n’attend pas.
Le déroulement
Le tableau indique pour chaque étape l’appel compétent et ce qui existe ensuite. La justification de l’étape figure en dessous.
| Étape | Appel | Ce qui existe ensuite |
|---|---|---|
| Commander les images | POST /vision/part/generate | Un travail avec jobId ; la génération continue, l’appel n’attend pas |
| Récupérer le travail | GET /vision/part/generation-jobs/{jobId} | Vues terminées sous leurs propres adresses dès la fin du travail |
| Insérer la pièce neuve | POST /vision/part/composite | La pièce sur un fond adapté au canal |
| Supprimer les identifiants | POST /vision/identifiers/redact | Les numéros propres à l’exemplaire disparaissent avant publication |
Pourquoi chaque étape est nécessaire
- Commander les images.
POST /vision/part/generateprend la référence OE et lance le travail. Par défaut,sourceModevautreferences_required; la génération sans référence se commande expressément avecknowledge_only. La réponse est unjobId, non une image — la génération prend du temps, et un appel bloquant serait inutilisable dans un import de catalogue. - Récupérer le travail.
GET /vision/part/generation-jobs/{jobId}renvoie les vues finies sous des adresses accessibles. C’est seulement là qu’on sait quelles perspectives ont réellement abouti. - Placer la pièce sur un fond.
POST /vision/part/compositeinsère une pièce neuve dans une image de fond. Les marketplaces et votre boutique exigent des univers visuels différents ; cette étape les sert. - Retirer les identifiants.
POST /vision/identifiers/redactanonymise les identifiants propres à l’exemplaire. Un numéro de série ou un identifiant imprimé n’a pas sa place dans une annonce publique — il identifie une pièce unique.
curl -X POST \
-H 'X-Api-Key: <API_KEY>' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: bilder-8k0959455k' \
-d '{"oeNumber":"8K0959455K","sourceMode":"knowledge_only","angles":["front","left_45","right_45"]}' \
'https://api.tapinomahub.com/vision/part/generate'Ce que l’on obtient
Il reste un jeu d’images utilisable au catalogue, toujours signalé comme généré et ne portant aucun identifiant d’un exemplaire tiers. Pour les pièces neuves, c’est la voie praticable ; pour l’occasion, votre propre photo reste le bon point de départ.
Où cela figure dans la documentation
Les listes de champs contractuelles, les codes d’erreur et les réponses d’exemple se trouvent dans le contrat OpenAPI de cette surface, à l’adresse docs.tapinomahub.com (tapinoma-hub). Tous les cas d’usage classés par surface et par rôle : aperçu des cas d’usage.
Sources et références juridiques
Questions fréquentes
La génération ne contredit-elle pas le principe de ne rien inventer ?
Non, car elle est expressément commandée. Ce qui est interdit, c’est combler une lacune de sorte qu’elle paraisse mesurée. Une vue signalée comme générée ne prétend pas être une photo.
Quand faut-il détourer à la place ?
Dès que vous avez une photo propre. C’est le rôle de POST /vision/part/remove/bg, qui reçoit l’adresse accessible de votre photo dans imageUrl.
Dois-je rendre la mention visible dans l’annonce ?
La façon de déclarer une image d’illustration dépend du canal et du droit de la concurrence. Techniquement l’origine reste identifiable ; la déclaration à l’acheteur vous incombe.