# 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…

- Pagina: <https://www.datafirefly.com/nl/documentation/df-ai-product-photography/>
- Taal: nl
- Bijgewerkt op: 2026-08-18
- Andere talen: [fr](https://www.datafirefly.com/documentation/df-ai-product-photography/index.md), [en](https://www.datafirefly.com/en/documentation/df-ai-product-photography/index.md), [es](https://www.datafirefly.com/es/documentation/df-ai-product-photography/index.md), [de](https://www.datafirefly.com/de/documentation/df-ai-product-photography/index.md), [it](https://www.datafirefly.com/it/documentation/df-ai-product-photography/index.md), [pl](https://www.datafirefly.com/pl/documentation/df-ai-product-photography/index.md), [pt](https://www.datafirefly.com/pt/documentation/df-ai-product-photography/index.md)
- Index: <https://www.datafirefly.com/nl/documentation/llms.txt>

## 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

**Belangrijk:** lokale sites (localhost, .test, .local) werken niet, omdat de AI-provider de URL van uw bronafbeelding niet kan bereiken. Gebruik een publiek toegankelijke stagingomgeving of een tunnel (ngrok, Cloudflare Tunnel).

## 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](https://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](https://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)

**Tip:** schrijf uw prompts in het Engels en beschrijf de omgeving, het licht en de fotografische stijl. De plugin voegt automatisch een beveiliging toe die het product intact houdt en tekst en watermerken vermijdt.

### 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.