Ein Neuteil kommt ins Sortiment und hat kein Bild. Ein Inserat ohne Bild verkauft schlecht, ein fremdes Herstellerbild ist rechtlich heikel, und ein eigenes Fotostudio rechnet sich erst bei grossen Stückzahlen. Für Gebrauchtteile gilt das nicht — dort liegt das Teil auf der Werkbank und kann fotografiert werden.
Hier gilt ausdrücklich eine Ausnahme von der Hausregel, dass nur Belegtes ausgegeben wird: Die Erzeugung ohne Referenzbild ist eine Leistung, die bestellt wird. Genau deshalb muss das Ergebnis als erzeugt gekennzeichnet sein und darf nicht als Aufnahme des eingelagerten Stücks erscheinen.
| Fläche | Rollen |
|---|---|
| Hub | Teilehandel, Plattform und Marktplatz, Fahrzeughandel |
Was dieser Fall voraussetzt
- Eine belastbare OE-Nummer. Erzeugt wird zu der Nummer, die Sie nennen. Eine falsche Nummer erzeugt ein falsches Teil, und das fällt erst beim Käufer auf.
- Die ausdrückliche Entscheidung für die Erzeugung. Liegt eine eigene Aufnahme vor, ist das Freistellen der richtige Weg.
- Eine Kennzeichnung im eigenen System. Ein erzeugtes Bild muss als solches erkennbar bleiben, auch nachdem es durch drei Systeme gelaufen ist.
- Geduld für einen Auftrag. Die Erzeugung läuft asynchron; der Aufruf gibt eine
jobIdzurück und wartet nicht.
Der Ablauf
Die Tabelle nennt je Stufe den zuständigen Aufruf und das, was danach vorliegt. Die Begründung, warum die Stufe nicht übersprungen werden kann, steht darunter.
| Stufe | Aufruf | Was danach vorliegt |
|---|---|---|
| Bilder beauftragen | POST /vision/part/generate | Ein Auftrag mit jobId; die Erzeugung läuft, der Aufruf wartet nicht |
| Auftrag abholen | GET /vision/part/generation-jobs/{jobId} | Fertige Ansichten unter eigenen Adressen, sobald der Auftrag durch ist |
| Neuteil einsetzen | POST /vision/part/composite | Das Teil vor einem Hintergrund, der zum Kanal passt |
| Kennungen entfernen | POST /vision/identifiers/redact | Instanzbezogene Nummern verschwinden, bevor das Bild öffentlich wird |
Warum jede Stufe nötig ist
- Die Bilder beauftragen.
POST /vision/part/generatenimmt die OE-Nummer und startet den Auftrag. Vorgabe fürsourceModeistreferences_required; die Erzeugung ohne Vorlage wird ausdrücklich mitknowledge_onlybestellt. Die Antwort ist einejobId, kein Bild — die Erzeugung braucht Zeit, und ein blockierter Aufruf wäre in einem Katalogimport unbrauchbar. - Den Auftrag abholen.
GET /vision/part/generation-jobs/{jobId}liefert die fertigen Ansichten unter abrufbaren Adressen. Erst hier steht fest, welche Perspektiven tatsächlich entstanden sind. - Das Teil in einen Hintergrund setzen.
POST /vision/part/compositesetzt ein Neuteil in ein Hintergrundbild. Marktplätze und eigener Shop verlangen unterschiedliche Bildwelten; dieser Schritt bedient sie. - Kennungen entfernen.
POST /vision/identifiers/redactanonymisiert instanzbezogene Kennungen in Teilebildern. Eine Seriennummer oder eine aufgedruckte Gerätekennung gehört nicht in ein öffentliches Inserat — sie identifiziert ein einzelnes Stück.
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'Was am Ende vorliegt
Am Ende steht ein Bildsatz, der im Katalog verwendbar ist, als erzeugt gekennzeichnet bleibt und keine Kennung eines fremden Einzelstücks trägt. Für Neuteile ist das der praktikable Weg; für Gebrauchtteile bleibt die eigene Aufnahme der richtige Ausgangspunkt.
Wo das in der Dokumentation steht
Die verbindlichen Feldlisten, Fehlercodes und Beispielantworten stehen im OpenAPI-Vertrag dieser Fläche unter docs.tapinomahub.com (tapinoma-hub). Alle Anwendungsfälle nach Fläche und Rolle geordnet: Übersicht der Anwendungsfälle.
Quellen und Rechtsgrundlagen
Häufige Fragen
Widerspricht die Erzeugung nicht dem Grundsatz, nichts zu erfinden?
Nein, weil sie ausdrücklich bestellt wird. Verboten ist das Ergänzen einer Lücke, die als Messung erscheint. Eine als erzeugt gekennzeichnete Ansicht behauptet nicht, eine Aufnahme zu sein.
Wann nehme ich stattdessen das Freistellen?
Immer, wenn eine eigene Aufnahme vorliegt. Dafür ist POST /vision/part/remove/bg vorgesehen; der Aufruf nimmt die abrufbare Adresse Ihrer Aufnahme als imageUrl entgegen.
Muss ich die Kennzeichnung im Inserat sichtbar machen?
Wie Sie ein Symbolbild ausweisen, richtet sich nach dem Kanal und dem Wettbewerbsrecht. Technisch bleibt die Herkunft erkennbar; die Kennzeichnung gegenüber dem Käufer liegt bei Ihnen.