AI Product Photography Studio — Guide complet

Présentation

AI Product Photography Studio transforme une photo produit sur fond blanc en mises en scène professionnelles générées par IA (Flux Kontext Pro via fal.ai ou Replicate). Le produit reste rigoureusement identique d’une scène à l’autre : seul l’environnement change. Le plugin s’intègre directement dans la fiche produit WooCommerce via une meta box dédiée, et les générations s’exécutent en arrière-plan grâce à Action Scheduler.

Prérequis

• WordPress 6.4 ou supérieur
• WooCommerce 8.0 ou supérieur (Action Scheduler inclus)
• PHP 8.1 ou supérieur
• Un site accessible en HTTPS — les providers IA doivent pouvoir télécharger vos images sources via une URL publique
• Un compte fal.ai ou Replicate avec une clé API active

Installation

1. Téléchargez le fichier df-ai-product-photography.zip depuis votre compte DataFirefly.
2. Dans WordPress, allez dans Extensions → Ajouter → Téléverser une extension.
3. Sélectionnez le ZIP puis cliquez sur Installer maintenant, puis Activer.
4. Un nouveau sous-menu WooCommerce → AI Photo Studio apparaît : c’est la page de réglages du plugin.

À l’activation, le plugin vérifie que PHP 8.1+ et WooCommerce sont présents. Si l’une des conditions n’est pas remplie, l’activation est refusée avec un message explicite.

Obtenir une clé API

Option A — fal.ai (recommandé en production)

1. Créez un compte sur fal.ai.
2. Ouvrez le dashboard puis la section Keys.
3. Générez une nouvelle clé et copiez-la (format xxxxxxxx-xxxx-...:yyyyyyyy).
4. Ajoutez du crédit à votre compte (facturation à l’usage, environ 0,04 € par image).

Option B — Replicate

1. Créez un compte sur replicate.com.
2. Allez dans Account → API tokens.
3. Générez un token (format r8_...) et copiez-le.
4. Renseignez un moyen de paiement (environ 0,06 € par image).

Configuration

Rendez-vous dans WooCommerce → AI Photo Studio. La page de réglages comporte quatre onglets.

Onglet Provider IA

• Choix du fournisseur : sélectionnez fal.ai ou Replicate via les cartes radio. Les deux utilisent le même modèle Flux Kontext Pro.
• Clé API fal.ai / Token API Replicate : collez la clé correspondante. Seule la clé du provider sélectionné est requise.
• Bouton Tester : vérifie que la clé est bien renseignée pour le provider choisi.

Onglet Paramètres de génération

• Ratio d’image : Identique à la source (défaut), 1:1, 4:3, 3:4, 16:9, 9:16, 3:2 ou 2:3.
• Format de sortie : JPEG (défaut) ou PNG.
• Tolérance modération : de 1 (très strict) à 6 (très permissif). La valeur 2 est recommandée pour le e-commerce.
• Guidance : force d’adhérence au prompt, de 1 à 10 (fal.ai uniquement). 3.5 par défaut.
• Galerie automatique : si coché, chaque image générée est immédiatement ajoutée à la galerie du produit sans intervention manuelle.

Onglet Scènes personnalisées

En plus des 12 scènes intégrées, vous pouvez déclarer vos propres mises en scène au format JSON :

[
  {
    "key": "loft_industriel",
    "label": "Loft industriel",
    "category": "lifestyle",
    "icon": "🏭",
    "description": "Décor brut métal et béton",
    "prompt": "Place this product in a modern industrial loft setting with exposed brick walls, concrete floor, large factory windows, dramatic natural light"
  }
]

• key : identifiant unique en minuscules sans espaces (obligatoire)
• label : nom affiché dans le sélecteur
• category : lifestyle, packshot, context ou seasonal
• prompt : instruction en anglais commençant idéalement par « Place this product… » (obligatoire)

Onglet Avancé

• Niveau de log : Désactivé, Erreurs uniquement (défaut) ou Verbose. Les logs sont consultables dans WooCommerce → État → Journaux, source df-ai-product-photography.
• Un encart d’informations techniques affiche les versions PHP / WordPress / WooCommerce et la présence d’Action Scheduler.

Générer des mises en scène

Ouvrez n’importe quel produit dans Produits → Tous les produits. La meta box 🎨 AI Product Photography Studio apparaît sous l’éditeur. Le workflow se déroule en trois étapes :

Étape 1 — Photo source

Choisissez l’image de départ : soit via Choisir depuis la médiathèque, soit via Utiliser l’image principale qui reprend l’image mise en avant du produit. Une photo nette sur fond blanc ou neutre donne les meilleurs résultats — un smartphone récent suffit.

Étape 2 — Sélection des scènes

Cochez les mises en scène désirées parmi les cartes, organisées par catégorie (Lifestyle, Packshot, Contexte d’usage, Saisonnier). Les liens rapides + Tous Lifestyle, + Tous Packshot, Tout sélectionner et Effacer accélèrent la sélection. Un lot est limité à 20 scènes maximum.

Étape 3 — Lancement

Ajoutez éventuellement des instructions additionnelles (ex. « éclairage chaud, couleurs automnales, style magazine ») qui seront appliquées à toutes les scènes du lot, puis cliquez sur ✨ Générer les mises en scène.

La colonne de droite 🖼️ Générations affiche l’état de chaque job en temps réel : En file → Envoi → Génération → Terminé ou Échec. Le statut se rafraîchit automatiquement toutes les 3,5 secondes. Comptez généralement 10 à 30 secondes par image.

Utiliser les images générées

Chaque image terminée propose trois actions :

• + Galerie : ajoute l’image à la galerie du produit WooCommerce (sans écraser les images existantes).
• Voir : ouvre l’image en pleine résolution dans un nouvel onglet.
• × : retire l’entrée de la liste (l’image reste dans la médiathèque).

Toutes les images générées sont importées dans la médiathèque WordPress avec des méta-données de traçabilité : _df_aipp_generated, _df_aipp_scene (nom de la scène) et _df_aipp_origin_product (produit d’origine). Vous pouvez donc les retrouver et les réutiliser librement.

Fonctionnement technique

Les générations sont asynchrones : au clic sur Générer, le plugin crée un job par scène et le planifie via Action Scheduler (hook df_aipp_submit_job). Chaque job soumet la requête au provider, récupère un identifiant, puis un second hook (df_aipp_poll_job) interroge le statut toutes les 5 secondes, jusqu’à 60 tentatives (~5 minutes). En cas d’erreur réseau transitoire, le job est retenté jusqu’à 3 fois avant d’être marqué en échec.

Vous pouvez observer et relancer les actions dans WooCommerce → État → Actions planifiées, groupe df-ai-product-photography.

Dépannage

Le bouton Générer est grisé

Le provider sélectionné n’a pas de clé API renseignée. Allez dans WooCommerce → AI Photo Studio → Provider IA et collez votre clé.

Les jobs restent bloqués en « En file »

Action Scheduler ne s’exécute pas. Vérifiez que WP-Cron fonctionne (visitez le site côté front, ou configurez un vrai cron serveur pointant sur wp-cron.php). Consultez WooCommerce → État → Actions planifiées pour voir les actions en attente.

Erreur « Image source introuvable » ou échec immédiat

Le provider n’arrive pas à télécharger votre image. Causes fréquentes : site en local non accessible publiquement, protection par htpasswd, hotlink protection au niveau serveur ou CDN bloquant les requêtes externes. Testez l’URL de l’image dans une fenêtre de navigation privée.

Erreur 401 / 403 renvoyée par le provider

Clé API invalide, expirée ou compte sans crédit. Régénérez la clé sur le dashboard du provider et vérifiez votre solde.

La génération aboutit mais l’image est refusée (safety)

Le modèle a jugé le contenu sensible. Augmentez la Tolérance modération dans les réglages (essayez 3 ou 4), ou reformulez le prompt de votre scène personnalisée.

Où trouver les logs détaillés ?

Passez le Niveau de log sur Verbose dans l’onglet Avancé, relancez une génération, puis consultez WooCommerce → État → Journaux et sélectionnez la source df-ai-product-photography.

Désinstallation

La désactivation seule ne supprime rien. La suppression du plugin déclenche uninstall.php qui efface les réglages globaux, les méta de jobs sur les produits et les actions planifiées restantes. Les images générées déjà présentes dans la médiathèque sont conservées.

FAQ

Puis-je utiliser les deux providers en parallèle ?

Le provider actif est global (un seul à la fois), mais vous pouvez basculer à tout moment dans les réglages : les nouvelles générations utiliseront le provider nouvellement sélectionné.

Les images générées sont-elles libres de droits ?

Selon les conditions de fal.ai et Replicate, les sorties générées avec votre compte vous appartiennent et sont utilisables commercialement. Vérifiez les CGU de votre provider pour votre cas d’usage.

Le plugin fonctionne-t-il avec les produits variables ?

Oui. La meta box est disponible sur tous les types de produits WooCommerce. Les images sont attachées à la galerie du produit parent.