AI Product Photography Studio — Komplette Anleitung

Überblick

AI Product Photography Studio verwandelt ein Produktfoto auf weißem Hintergrund in professionelle, KI-generierte Szenen (Flux Kontext Pro via fal.ai oder Replicate). Das Produkt bleibt von einer Szene zur nächsten absolut identisch: nur die Umgebung ändert sich. Das Plugin integriert sich direkt in die WooCommerce-Produktbearbeitung über eine dedizierte Meta-Box, und Generierungen laufen im Hintergrund über Action Scheduler.

Voraussetzungen

• WordPress 6.4 oder höher
• WooCommerce 8.0 oder höher (Action Scheduler enthalten)
• PHP 8.1 oder höher
• Eine über HTTPS erreichbare Website — KI-Anbieter müssen Ihre Quellbilder über eine öffentliche URL herunterladen können
• Ein fal.ai- oder Replicate-Konto mit aktivem API-Schlüssel

Installation

1. Laden Sie die Datei df-ai-product-photography.zip aus Ihrem DataFirefly-Konto herunter.
2. Gehen Sie in WordPress zu Plugins → Installieren → Plugin hochladen.
3. Wählen Sie das ZIP, klicken Sie auf Jetzt installieren, dann auf Aktivieren.
4. Ein neues Untermenü WooCommerce → AI Photo Studio erscheint: das ist die Einstellungsseite des Plugins.

Bei der Aktivierung prüft das Plugin, ob PHP 8.1+ und WooCommerce vorhanden sind. Ist eine Bedingung nicht erfüllt, wird die Aktivierung mit einer klaren Meldung abgelehnt.

API-Schlüssel erhalten

Option A — fal.ai (empfohlen für Produktion)

1. Erstellen Sie ein Konto auf fal.ai.
2. Öffnen Sie das Dashboard, dann den Bereich Keys.
3. Generieren Sie einen neuen Schlüssel und kopieren Sie ihn (Format xxxxxxxx-xxxx-...:yyyyyyyy).
4. Fügen Sie Ihrem Konto Guthaben hinzu (Pay-per-Use, etwa 0,04 € pro Bild).

Option B — Replicate

1. Erstellen Sie ein Konto auf replicate.com.
2. Gehen Sie zu Account → API tokens.
3. Generieren Sie ein Token (Format r8_...) und kopieren Sie es.
4. Hinterlegen Sie eine Zahlungsmethode (etwa 0,06 € pro Bild).

Konfiguration

Gehen Sie zu WooCommerce → AI Photo Studio. Die Einstellungsseite hat vier Reiter.

Reiter KI-Anbieter

• Anbieterauswahl: wählen Sie fal.ai oder Replicate über die Radio-Karten. Beide nutzen dasselbe Flux-Kontext-Pro-Modell.
• fal.ai API-Schlüssel / Replicate API-Token: fügen Sie den entsprechenden Schlüssel ein. Nur der Schlüssel des gewählten Anbieters ist erforderlich.
• Testen-Button: prüft, ob für den gewählten Anbieter ein Schlüssel hinterlegt ist.

Reiter Generierungsparameter

• Bildverhältnis: Wie Quellbild (Standard), 1:1, 4:3, 3:4, 16:9, 9:16, 3:2 oder 2:3.
• Ausgabeformat: JPEG (Standard) oder PNG.
• Moderationstoleranz: von 1 (sehr streng) bis 6 (sehr permissiv). 2 wird für E-Commerce empfohlen.
• Guidance: Prompt-Treue, von 1 bis 10 (nur fal.ai). Standard: 3,5.
• Automatische Galerie: wenn aktiviert, wird jedes generierte Bild sofort ohne manuelles Zutun zur Produktgalerie hinzugefügt.

Reiter Eigene Szenen

Zusätzlich zu den 12 integrierten Szenen können Sie eigene Szenen in JSON deklarieren:

[
  {
    "key": "industrie_loft",
    "label": "Industrie-Loft",
    "category": "lifestyle",
    "icon": "🏭",
    "description": "Rohes Metall- und Beton-Setting",
    "prompt": "Place this product in a modern industrial loft setting with exposed brick walls, concrete floor, large factory windows, dramatic natural light"
  }
]

• key: eindeutige Kennung in Kleinbuchstaben ohne Leerzeichen (Pflicht)
• label: im Selektor angezeigter Name
• category: lifestyle, packshot, context oder seasonal
• prompt: englische Anweisung, idealerweise beginnend mit „Place this product…“ (Pflicht)

Reiter Erweitert

• Log-Stufe: Deaktiviert, Nur Fehler (Standard) oder Verbose. Logs finden Sie unter WooCommerce → Status → Logs, Quelle df-ai-product-photography.
• Ein Technik-Block zeigt PHP- / WordPress- / WooCommerce-Versionen und die Verfügbarkeit von Action Scheduler.

Szenen generieren

Öffnen Sie ein beliebiges Produkt unter Produkte → Alle Produkte. Die Meta-Box 🎨 AI Product Photography Studio erscheint unter dem Editor. Der Workflow hat drei Schritte:

Schritt 1 — Quellfoto

Wählen Sie das Ausgangsbild: entweder über Aus Mediathek wählen oder über Beitragsbild verwenden, das das Beitragsbild des Produkts übernimmt. Ein scharfes Foto auf weißem oder neutralem Hintergrund liefert die besten Ergebnisse — ein aktuelles Smartphone genügt.

Schritt 2 — Szenenauswahl

Kreuzen Sie die gewünschten Szenen unter den Karten an, organisiert nach Kategorie (Lifestyle, Packshot, Anwendungskontext, Saisonal). Die Schnell-Links + Alle Lifestyle, + Alle Packshot, Alle auswählen und Leeren beschleunigen die Auswahl. Ein Batch ist auf 20 Szenen begrenzt.

Schritt 3 — Start

Fügen Sie optional Zusatzanweisungen hinzu (z. B. „warmes Licht, Herbsttöne, Magazin-Stil“), die auf alle Szenen des Batches angewendet werden, und klicken Sie auf ✨ Szenen generieren.

Die rechte Spalte 🖼️ Generierungen zeigt den Zustand jedes Jobs in Echtzeit: Warteschlange → Senden → Generieren → Fertig oder Fehler. Der Status aktualisiert sich automatisch alle 3,5 Sekunden. Rechnen Sie mit etwa 10 bis 30 Sekunden pro Bild.

Generierte Bilder verwenden

Jedes fertige Bild bietet drei Aktionen:

• + Galerie: fügt das Bild zur WooCommerce-Produktgalerie hinzu (ohne vorhandene Bilder zu überschreiben).
• Ansehen: öffnet das Bild in voller Auflösung in einem neuen Tab.
• ×: entfernt den Eintrag aus der Liste (das Bild bleibt in der Mediathek).

Alle generierten Bilder werden mit Nachverfolgbarkeits-Metadaten in die WordPress-Mediathek importiert: _df_aipp_generated, _df_aipp_scene (Szenenname) und _df_aipp_origin_product (Ursprungsprodukt). Sie können sie frei wiederfinden und weiterverwenden.

Technische Funktionsweise

Generierungen sind asynchron: bei Klick auf Generieren erstellt das Plugin einen Job pro Szene und plant ihn über Action Scheduler (Hook df_aipp_submit_job). Jeder Job übermittelt die Anfrage an den Anbieter, erhält eine Kennung, dann fragt ein zweiter Hook (df_aipp_poll_job) den Status alle 5 Sekunden ab, bis zu 60 Versuche (~5 Minuten). Bei vorübergehenden Netzwerkfehlern wird der Job bis zu 3 Mal wiederholt, bevor er als fehlgeschlagen markiert wird.

Sie können Aktionen unter WooCommerce → Status → Geplante Aktionen, Gruppe df-ai-product-photography, beobachten und neu starten.

Fehlerbehebung

Der Generieren-Button ist ausgegraut

Der gewählte Anbieter hat keinen API-Schlüssel hinterlegt. Gehen Sie zu WooCommerce → AI Photo Studio → KI-Anbieter und fügen Sie Ihren Schlüssel ein.

Jobs bleiben in „Warteschlange“ hängen

Action Scheduler läuft nicht. Prüfen Sie, ob WP-Cron funktioniert (besuchen Sie das Frontend der Website oder richten Sie einen echten Server-Cron auf wp-cron.php ein). Prüfen Sie WooCommerce → Status → Geplante Aktionen auf ausstehende Aktionen.

Fehler „Quellbild nicht gefunden“ oder sofortiger Fehlschlag

Der Anbieter kann Ihr Bild nicht herunterladen. Häufige Ursachen: lokale, nicht öffentlich erreichbare Website, htpasswd-Schutz, serverseitiger Hotlink-Schutz oder ein CDN, das externe Anfragen blockiert. Testen Sie die Bild-URL in einem privaten Browserfenster.

Fehler 401 / 403 vom Anbieter

Ungültiger oder abgelaufener API-Schlüssel oder Konto ohne Guthaben. Generieren Sie den Schlüssel im Anbieter-Dashboard neu und prüfen Sie Ihr Guthaben.

Generierung läuft durch, aber das Bild wird abgelehnt (Safety)

Das Modell stufte den Inhalt als sensibel ein. Erhöhen Sie die Moderationstoleranz in den Einstellungen (versuchen Sie 3 oder 4) oder formulieren Sie den Prompt Ihrer eigenen Szene um.

Wo finde ich detaillierte Logs?

Stellen Sie die Log-Stufe im Reiter Erweitert auf Verbose, starten Sie eine Generierung neu und prüfen Sie WooCommerce → Status → Logs mit der Quelle df-ai-product-photography.

Deinstallation

Die Deaktivierung allein entfernt nichts. Das Löschen des Plugins löst uninstall.php aus, das globale Einstellungen, Job-Metadaten an Produkten und verbleibende geplante Aktionen entfernt. Bereits in der Mediathek vorhandene generierte Bilder bleiben erhalten.

FAQ

Kann ich beide Anbieter parallel nutzen?

Der aktive Anbieter ist global (einer gleichzeitig), aber Sie können jederzeit in den Einstellungen wechseln: neue Generierungen nutzen den neu gewählten Anbieter.

Sind die generierten Bilder lizenzfrei?

Gemäß den Bedingungen von fal.ai und Replicate gehören die mit Ihrem Konto generierten Ausgaben Ihnen und sind kommerziell nutzbar. Prüfen Sie die AGB Ihres Anbieters für Ihren konkreten Anwendungsfall.

Funktioniert das Plugin mit variablen Produkten?

Ja. Die Meta-Box ist bei allen WooCommerce-Produkttypen verfügbar. Bilder werden der Galerie des übergeordneten Produkts zugeordnet.