CommunityBildgithub.com

Fishkiller111/ai-ecommerce-product-images

Erstelle aus echten Produktfotos weiße Hintergrundbilder und E-Commerce-Produktbilder. Bewahrt Originalität: Verpackung, Text, Farbe, Struktur und Proportionen bleiben unverändert. Nutzt APIMarts gpt-image-2.6-flare-ext für Bildbearbeitung und -generierung.

Was ist ai-ecommerce-product-images?

Dieses Skill ermöglicht es KI-Agenten (z. B. Claude Code, Cursor, Codex), aus einem echten Produktfoto zwei fertige Bilder zu generieren: ein weiß hinterlegtes, originalgetreues Freistellungsbild und ein darauf basierendes, realistisches E-Commerce-Hauptbild. Es ist für Agenten gedacht, die Produktfotos für Online-Shops, Marktplätze oder Werbung aufbereiten müssen. Das Skill unterstützt die APIMart-Plattform mit dem Modell `gpt-image-2.6-flare-ext` und führt einen strengen, zweistufigen Workflow durch: Zuerst wird das Original hochgeladen und ein weißes Hintergrundbild mit exakter Produkttreue erstellt (keine Textänderungen, keine neuen Elemente). Nach einer obligatorischen Prüfung auf Integrität von Verpackung, Schrift, Farbe und Proportionen wird dieses weiße Bild als einzige Produktquelle für ein glaubwürdiges E-Commerce-Hauptbild verwendet. Optional kann ein Stilreferenzbild für Komposition und Beleuchtung angegeben werden, ohne die Produktidentität zu beeinflussen. Das Skill lehnt generierte Bilder ab, wenn die Prüfung fehlschlägt, und gibt klare Fehlermeldungen aus. Es schützt vor API-Key-Leaks und verhindert, dass das Originalprodukt durch Design oder Fantasieelemente verfälscht wird.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Fishkiller111/ecommerce-product-image-skills/tree/HEAD/skills/ai-ecommerce-product-images

Installed? Explore more Bild skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

E-Commerce-Produktbilderstellung

Ziel

Ein echtes Produktfoto schnell in zwei lieferbare Bilder umwandeln:

  1. Weiß hinterlegtes, originalgetreues Bild: Hintergrund entfernt, Produkt auf reinweißem Hintergrund, alle äußeren Merkmale und Verpackungsinformationen bleiben erhalten.
  2. Realistisches E-Commerce-Hauptbild: Basierend ausschließlich auf dem originalgetreuen Bild als Quelle der Produktwahrheit wird ein sauberes, glaubwürdiges, für E-Commerce geeignetes Szenenbild generiert.

Standardmäßig werden nur notwendige Anpassungen bei Licht, Komposition und Hintergrund vorgenommen; das Produkt wird nicht „neu gestaltet“.

Eingabe

  • SOURCE_IMAGE: Das vom Kunden bereitgestellte Originalproduktfoto, erforderlich.
  • STYLE_REFERENCE: Optionales Referenzbild für E-Commerce-Komposition. Es werden nur Layout, Licht, Weißraum und Informationsebenen referenziert, nicht das Produkt, der Text, Preise, Zertifikate oder Werbeaussagen.
  • OUTPUT_DIR: Ausgabeverzeichnis; Standard: ./outputs/product-images/.

Bei mehreren Bildern wird zuerst bewertet, welches das Produktfoto und welches nur ein Stilreferenzbild ist. Die Produktdetails des Stilreferenzbildes dürfen nicht auf das Originalprodukt übertragen werden.

Fester Ablauf

1. APIMart-Regeln lesen

Verwende das in der aktuellen Umgebung verfügbare APIMart-Tool oder rufe die APIMart-Schnittstelle gemäß der offiziellen API-Dokumentation (Upload, Authentifizierung, asynchrones Polling) auf. Der API-Key wird aus der Umgebungsvariablen APIMART_API_KEY oder einem gesicherten Berechtigungsmanager gelesen; die Dienstadresse wird aus APIMART_BASE_URL oder der offiziellen Konfiguration des Anbieters bezogen. Schlüssel, Benutzerdateien oder temporäre URLs dürfen nicht in Skill-Dateien, Skripten, Logs oder Liefertexten gespeichert werden. Fehlen Berechtigungen oder die Dienstadresse, wird angegeben, dass eine Konfiguration erforderlich ist; keine fremden Schlüssel verwenden oder suchen. Die API kann kostenpflichtig sein; wenn der Benutzer die Nutzung von APIMart für das Originalbild autorisiert hat, wird die Aufgabe ausgeführt und die Kosten werden mitgeteilt. Ohne Autorisierung, bei Upload-Verweigerung oder fehlender Konfiguration wird dies zuerst erklärt.

Das Hauptmodell ist fest auf gpt-image-2.6-flare-ext eingestellt. Wenn die Schnittstelle explizit „Modell existiert nicht“ zurückgibt, darf auf ein verfügbares GPT-Image-Erweiterungsmodell von APIMart ausgewichen werden; dies wird im Ergebnis vermerkt. Kein stiller Modellwechsel.

2. Originalbild hochladen

Lade SOURCE_IMAGE über die APIMart-Bildupload-Schnittstelle hoch und erhalte source_url. Falls STYLE_REFERENCE vorhanden, separat hochladen und style_url erhalten. Nach dem Upload wird sofort ein Aufgabenprotokoll gespeichert; temporäre URLs werden nicht in die Kundenliefertexte geschrieben.

3. Weiß hinterlegtes, originalgetreues Bild generieren

Rufe die APIMart-Bildgenerierungs-/Bearbeitungsschnittstelle auf und verwende source_url als einzige Produktreferenz. Der Prompt verwendet direkt die folgende Vorlage, wobei der Inhalt in eckigen Klammern ersetzt wird:

Edit the provided product photo into a clean e-commerce white-background product cutout.
The product identity is locked to the source image.
Preserve exactly: package shape, front and side panels, dimensions, proportions, colors,
logos, labels, Chinese text, English text, dosage/volume markings, seals, caps, edges,
folds and all visible printed details.
Remove only the original environment and background. Use a pure white background,
soft natural contact shadow, centered product, full product visible, realistic camera
perspective, accurate geometry, high-detail commercial photography.
Do not redesign, beautify into another product, rewrite text, translate text, add text,
remove text, change the package, change the brand, change the logo, change the color,
add props, add people, add medical claims, add badges, add price tags or add decorative
copy. If any printed text is uncertain, preserve the original appearance rather than
inventing a replacement.

Ausgabename: 01_white_bg_preserved.png.

4. Treueprüfung

Vor der Erstellung des E-Commerce-Bildes muss das weiße Bild geprüft werden:

  • Stimmen Vorderseite, Seiten, Oberseite und Ecken der Verpackung mit dem Original überein?
  • Haben sich Anzahl der Produkte, Größenverhältnisse, Farben, Perspektive und Struktur verändert?
  • Wurden Marke, Logo, Zulassungsnummer, Spezifikationen, chinesische und englische Texte neu geschrieben oder verfälscht?
  • Sind zusätzliche Flaschen, Schachteln, Pflanzen, Pillen, Personen, Preise, Zertifikate, Wirksamkeitsbegriffe oder Dekorationselemente aufgetaucht?
  • Ist der Hintergrund weiß, das Produkt vollständig und gibt es offensichtliche Freistellungsartefakte oder Durchsickerungen?

Bei jedem Fehlschlag: Das Bild wird nicht als fertig ausgeliefert. Mit demselben Originalbild wird der Prompt verstärkt („identity locked / preserve exact packaging / no new text“) und maximal ein weiterer Versuch unternommen. Bei erneutem Fehlschlag wird das Bild eindeutig als ABGELEHNT markiert; kein Vortäuschen einer Fertigstellung und keine Endlosschleife.

5. Realistisches E-Commerce-Hauptbild generieren

Verwende 01_white_bg_preserved.png als Produkttatsache; STYLE_REFERENCE dient nur als Kompositionsreferenz. Der Prompt lautet:

Create one realistic e-commerce product hero image using the provided preserved product cutout.
The supplied cutout is the exact product truth and must remain unchanged.
Keep the same package shape, logo, brand, printed text, colors, proportions, side panel,
volume markings and all visible details. Do not redraw or reinterpret the product.
Build a clean, credible commercial composition with [SCENE], [LIGHTING], [CAMERA_ANGLE]
and generous negative space. Use premium but restrained styling, realistic shadows and
accurate materials. No people, no hands, no extra products, no medical advice, no efficacy
claims, no price, no platform badge, no invented slogan, no invented certification, no
new package text and no visual element that could be mistaken as part of the product.
The final image must look like a real product photograph, not an illustration or a fantasy ad.

Standardparameter:

  • SCENE: Einfach, realistisch, zur Produktkategorie passend.
  • LIGHTING: Weiches natürliches Licht, übermäßige Glättung, Überbelichtung und Plastiklook vermeiden.
  • CAMERA_ANGLE: Leicht dreiviertel, so dass Vorderseite und notwendige Seiten lesbar sind.
  • Seitenverhältnis bevorzugt 1:1; für horizontale Detailseitenbilder kann 4:5 oder 3:4 verwendet werden.
  • Standardauflösung: 2k; nur bei ausdrücklichem Kundenwunsch höhere Auflösung.

Ausgabename: 02_ecommerce_hero.png.

6. E-Commerce-Bildprüfung

Sicherstellen: Produkt ist noch das Original; Verpackungstext wurde nicht geändert; Szene erzeugt keine Wirksamkeitshinweise; keine Preise, Plattform-Logos, erfundene Zertifikate oder übertriebene Werbeaussagen; Komposition geeignet für E-Commerce-Thumbnails und Detailseiten; keine offensichtlichen KI-Generierungsartefakte.

Ausgabe-Vereinbarung

Es werden nur folgende Dateien ausgeliefert:

OUTPUT_DIR/
├── 01_white_bg_preserved.png
└── 02_ecommerce_hero.png

Wenn eine Stufe fehlschlägt, werden der Fehlergrund, der Pfad des fehlgeschlagenen Bildes und die nächste Korrektur ausgegeben; keine fehlerhaften Bilder ausliefern.

Die Ergebnisbeschreibung besteht nur aus drei Zeilen:

Original: <Dateiname>
Ergebnis: Weiß hinterlegtes Bild <Pfad>; E-Commerce-Hauptbild <Pfad>
Prüfung: Produktidentität/Verpackungstext/Struktur und Proportionen geprüft; <Bestanden oder Grund für Wiederholung>

Verbotene Handlungen

  • Das Originalprodukt nicht in ein anderes Produkt umschönen.
  • Keine eigenmächtigen Änderungen oder Ergänzungen an Verpackungstext, Marke, Logo, Zulassungsnummer, Spezifikationen und Preis.
  • Das Stilreferenzbild nicht als Produkttatsache behandeln.
  • Keine gesundheitsbezogenen Aussagen, Heilungsversprechen, absolute Behauptungen oder nicht bereitgestellte Werbeslogans für Medikamente, Nahrungsergänzungsmittel oder medizinische Produkte hinzufügen.
  • Den APIMart-API-Key nicht preisgeben; kein Speichern des Schlüssels in Skill-Dateien, Logs, Bild-Metadaten oder Kundendokumenten.
  • Die Treueprüfung nicht umgehen; wenn das weiße Bild die Prüfung nicht besteht, wird kein E-Commerce-Bild generiert.

Verwandte Skills