AI Product Photography Studio: volledige handleiding

Overzicht

AI Product Photography Studio zet een productfoto op witte achtergrond om in professionele scènes die door AI worden gegenereerd (Flux Kontext Pro via fal.ai of Replicate). Het product blijft van scène tot scène exact hetzelfde: alleen de omgeving verandert. De plugin integreert rechtstreeks in de WooCommerce-productpagina via een eigen metabox, en de generaties draaien op de achtergrond dankzij Action Scheduler.

Vereisten

• WordPress 6.4 of hoger
• WooCommerce 8.0 of hoger (Action Scheduler inbegrepen)
• PHP 8.1 of hoger
• Een site die via HTTPS bereikbaar is: de AI-providers moeten uw bronafbeeldingen kunnen downloaden via een publieke URL
• Een account bij fal.ai of Replicate met een actieve API-sleutel

Installatie

1. Download het bestand df-ai-product-photography.zip vanuit uw DataFirefly-account.
2. Ga in WordPress naar Plugins → Nieuwe plugin → Plugin uploaden.
3. Selecteer de ZIP, klik op Nu installeren en vervolgens op Activeren.
4. Er verschijnt een nieuw submenu WooCommerce → AI Photo Studio: dat is de instellingenpagina van de plugin.

Bij activering controleert de plugin of PHP 8.1+ en WooCommerce aanwezig zijn. Wordt aan een van beide voorwaarden niet voldaan, dan wordt de activering geweigerd met een duidelijke melding.

Een API-sleutel verkrijgen

Optie A: fal.ai (aanbevolen voor productie)

1. Maak een account aan op fal.ai.
2. Open het dashboard en ga naar het onderdeel Keys.
3. Genereer een nieuwe sleutel en kopieer die (formaat xxxxxxxx-xxxx-...:yyyyyyyy).
4. Zet tegoed op uw account (facturering op gebruiksbasis, ongeveer 0,04 euro per afbeelding).

Optie B: Replicate

1. Maak een account aan op replicate.com.
2. Ga naar Account → API tokens.
3. Genereer een token (formaat r8_...) en kopieer het.
4. Voeg een betaalmethode toe (ongeveer 0,06 euro per afbeelding).

Configuratie

Ga naar WooCommerce → AI Photo Studio. De instellingenpagina bestaat uit vier tabbladen.

Tabblad AI-provider

• Keuze van de provider: selecteer fal.ai of Replicate via de keuzekaarten. Beide gebruiken hetzelfde model Flux Kontext Pro.
• API-sleutel fal.ai / API-token Replicate: plak de bijbehorende sleutel. Alleen de sleutel van de geselecteerde provider is vereist.
• Knop Testen: controleert of de sleutel voor de gekozen provider correct is ingevuld.

Tabblad Generatie-instellingen

• Beeldverhouding: Gelijk aan de bron (standaard), 1:1, 4:3, 3:4, 16:9, 9:16, 3:2 of 2:3.
• Uitvoerformaat: JPEG (standaard) of PNG.
• Moderatietolerantie: van 1 (zeer streng) tot 6 (zeer soepel). Waarde 2 wordt aanbevolen voor e-commerce.
• Guidance: mate waarin de prompt wordt gevolgd, van 1 tot 10 (alleen fal.ai). Standaard 3.5.
• Automatische galerij: indien aangevinkt wordt elke gegenereerde afbeelding meteen aan de productgalerij toegevoegd, zonder handmatige actie.

Tabblad Aangepaste scènes

Naast de 12 ingebouwde scènes kunt u uw eigen scènes definiëren in JSON-formaat:

[
  {
    "key": "industriele_loft",
    "label": "Industriële loft",
    "category": "lifestyle",
    "icon": "🏭",
    "description": "Ruw decor van metaal en beton",
    "prompt": "Place this product in a modern industrial loft setting with exposed brick walls, concrete floor, large factory windows, dramatic natural light"
  }
]

• key: unieke identificatie in kleine letters zonder spaties (verplicht)
• label: naam die in de keuzelijst wordt getoond
• category: lifestyle, packshot, context of seasonal
• prompt: instructie in het Engels, bij voorkeur beginnend met “Place this product…” (verplicht)

Tabblad Geavanceerd

• Logniveau: Uitgeschakeld, Alleen fouten (standaard) of Verbose. De logbestanden vindt u in WooCommerce → Status → Logs, bron df-ai-product-photography.
• Een informatiekader toont de versies van PHP, WordPress en WooCommerce en of Action Scheduler aanwezig is.

Scènes genereren

Open een willekeurig product via Producten → Alle producten. De metabox 🎨 AI Product Photography Studio verschijnt onder de editor. De workflow bestaat uit drie stappen:

Stap 1: bronfoto

Kies de startafbeelding: via Kiezen uit de mediabibliotheek of via Productafbeelding gebruiken, waarmee de uitgelichte afbeelding van het product wordt overgenomen. Een scherpe foto op een witte of neutrale achtergrond geeft het beste resultaat; een recente smartphone volstaat.

Stap 2: scènes selecteren

Vink de gewenste scènes aan op de kaarten, gegroepeerd per categorie (Lifestyle, Packshot, Gebruikscontext, Seizoensgebonden). De snelkoppelingen + Alle Lifestyle, + Alle Packshot, Alles selecteren en Wissen versnellen de selectie. Per batch zijn maximaal 20 scènes toegestaan.

Stap 3: starten

Voeg eventueel extra instructies toe (bijvoorbeeld “warme belichting, herfstkleuren, magazinestijl”) die op alle scènes van de batch worden toegepast, en klik daarna op ✨ Scènes genereren.

De rechterkolom 🖼️ Generaties toont de status van elke taak in realtime: In wachtrij → Verzenden → Genereren → Voltooid of Mislukt. De status ververst automatisch elke 3,5 seconden. Reken doorgaans op 10 tot 30 seconden per afbeelding.

De gegenereerde afbeeldingen gebruiken

Bij elke voltooide afbeelding zijn drie acties beschikbaar:

• + Galerij: voegt de afbeelding toe aan de WooCommerce-productgalerij (zonder bestaande afbeeldingen te overschrijven).
• Bekijken: opent de afbeelding op volledige resolutie in een nieuw tabblad.
• ×: verwijdert het item uit de lijst (de afbeelding blijft in de mediabibliotheek).

Alle gegenereerde afbeeldingen worden in de WordPress-mediabibliotheek geïmporteerd met metagegevens voor traceerbaarheid: _df_aipp_generated, _df_aipp_scene (naam van de scène) en _df_aipp_origin_product (oorspronkelijk product). U kunt ze dus terugvinden en vrij hergebruiken.

Technische werking

De generaties verlopen asynchroon: bij een klik op Genereren maakt de plugin per scène een taak aan en plant die via Action Scheduler (hook df_aipp_submit_job). Elke taak dient het verzoek in bij de provider, ontvangt een identificatie, waarna een tweede hook (df_aipp_poll_job) de status elke 5 seconden opvraagt, tot 60 pogingen (ongeveer 5 minuten). Bij een tijdelijke netwerkfout wordt de taak tot 3 keer opnieuw geprobeerd voordat ze als mislukt wordt gemarkeerd.

U kunt de acties bekijken en opnieuw starten via WooCommerce → Status → Geplande acties, groep df-ai-product-photography.

Probleemoplossing

De knop Genereren is grijs

Voor de geselecteerde provider is geen API-sleutel ingevuld. Ga naar WooCommerce → AI Photo Studio → AI-provider en plak uw sleutel.

De taken blijven op “In wachtrij” staan

Action Scheduler draait niet. Controleer of WP-Cron werkt (bezoek de front-end van de site of stel een echte servercron in die wp-cron.php aanroept). Raadpleeg WooCommerce → Status → Geplande acties om de wachtende acties te zien.

Foutmelding “Bronafbeelding niet gevonden” of directe mislukking

De provider kan uw afbeelding niet downloaden. Veelvoorkomende oorzaken: een lokale site die niet publiek bereikbaar is, beveiliging met htpasswd, hotlinkbeveiliging op serverniveau of een CDN dat externe verzoeken blokkeert. Test de URL van de afbeelding in een privévenster.

Fout 401 / 403 van de provider

De API-sleutel is ongeldig of verlopen, of het account heeft geen tegoed. Genereer de sleutel opnieuw in het dashboard van de provider en controleer uw saldo.

De generatie lukt maar de afbeelding wordt geweigerd (safety)

Het model beoordeelde de inhoud als gevoelig. Verhoog de Moderatietolerantie in de instellingen (probeer 3 of 4) of herformuleer de prompt van uw aangepaste scène.

Waar vind ik gedetailleerde logs?

Zet het Logniveau op Verbose in het tabblad Geavanceerd, start een nieuwe generatie en raadpleeg daarna WooCommerce → Status → Logs met de bron df-ai-product-photography.

Verwijderen

Alleen deactiveren verwijdert niets. Het verwijderen van de plugin activeert uninstall.php, dat de globale instellingen, de taakmeta op de producten en de resterende geplande acties wist. Gegenereerde afbeeldingen die al in de mediabibliotheek staan, blijven behouden.

Veelgestelde vragen

Kan ik beide providers tegelijk gebruiken?

De actieve provider geldt voor de hele site (één tegelijk), maar u kunt op elk moment wisselen in de instellingen: nieuwe generaties gebruiken dan de nieuw geselecteerde provider.

Zijn de gegenereerde afbeeldingen rechtenvrij?

Volgens de voorwaarden van fal.ai en Replicate zijn de resultaten die met uw account worden gegenereerd uw eigendom en commercieel bruikbaar. Controleer de algemene voorwaarden van uw provider voor uw specifieke gebruikssituatie.

Werkt de plugin met variabele producten?

Ja. De metabox is beschikbaar bij alle WooCommerce-producttypen. De afbeeldingen worden toegevoegd aan de galerij van het bovenliggende product.