---
name: catalogue-modeles-generation-visuelle
description: Guide de décision et catalogue exhaustif des modèles fal.ai pour l'édition d'image, suppression d'objet, animation (I2V) et restylisation vidéo (V2V) — A CONSULTER OBLIGATOIREMENT AVANT TOUTE GENERATION
statut: vivant — enrichi continuellement après chaque test de production
derniere_mise_a_jour: 2026-10-25
---

# 🧰 Catalogue de Modèles fal.ai — Guide de Décision Visuelle & Vidéo

## 1. Raison d'être & Règle d'Or de Sélection

### Pourquoi ce catalogue est obligatoire
Le pipeline de production visuelle e-commerce ne peut pas reposer sur un modèle générique unique. 
* **L'erreur historique du projet** : L'utilisation par défaut de `fal-ai/nano-banana/edit` pour **toutes** les opérations (y compris la suppression d'objets ou de personnages) entraînait des régressions systématiques : le modèle régénérait l'arrière-plan complet, altérait le produit ou déformait le mécanisme.
* **Le constat validé** : Dès l'introduction de `fal-ai/bria/eraser` pour une suppression de personnage sur une photo réelle du bac, le nettoyage s'est fait **pixel-par-pixel** du premier coup, sans aucune altération du mécanisme.

> [!IMPORTANT]
> **RÈGLE D'OR DE SÉLECTION** : Identifier le **TYPE EXACT DE TÂCHE** avant de choisir le modèle. Ne jamais utiliser un modèle créatif générique (`nano-banana/edit`) lorsqu'un modèle spécialisé (inpainting déterministe, édition atomique, restylisation V2V) existe.
>
> **Règle ajoutée le 05/09/2026** : pour une édition créative avec **2 images de référence ou plus**, utiliser `fal-ai/nano-banana-pro/edit` (pas le standard) — incident réel : le standard a fait "fuir" un logo d'une image de référence vers le résultat final sur un cas à 2 références (tentative de correction des racines, étape plantation du guide).
>
> **Depuis le 05/09/2026, cette règle n'est plus seulement écrite ici** — elle est aussi encodée en code testable dans `recommend_model()` (`PROJET_STUDIO_PUB/studio/providers/visual_pipeline_helpers.py`). Avant cette date, ce catalogue n'était qu'un document lu et appliqué "à la main" par l'agent à chaque génération (une texte-consigne, pas du code déterministe) — préférer désormais l'appel à `recommend_model(task, n_references)` plutôt que de relire ce tableau et choisir soi-même, pour la sélection standard/Pro au moins.

---

## 2. Matrice de Décision Rapide (Cheat Sheet)

| Tâche Visuelle | Modèle Recommandé | Endpoint fal.ai Exact | Rendu / Caractéristique Clé | Coût Indicatif / Vitesse |
|---|---|---|---|---|
| **Suppression nette d'objet/personnage** | **Bria Eraser** | `fal-ai/bria/eraser` ✅ vérifié en production | Masque manuel (`mask_type: "manual"`). Préserve le reste de l'image pixel pour pixel. | Non facturé précisément (voir `fal_costs.jsonl`) |
| **Suppression d'arrière-plan** | **Bria Background Remove** | `fal-ai/bria/background/remove` ✅ slug corrigé le 04/09 (Antigravity avait écrit `bria/rmbg-2.0`, qui n'existe pas — 404 constaté) — alternative : `fal-ai/birefnet/v2` (meilleur sur les détails fins type cheveux) | Détourage RGBA précis. | ⚠️ prix non vérifié |
| **Édition atomique (1 seul élément)** | **Qwen Image Edit** | `fal-ai/qwen-image-edit` ✅ vérifié le 04/09 (page officielle https://fal.ai/models/fal-ai/qwen-image-edit) | Change la couleur, le fond ou 1 objet avec haute capacité d'édition de texte. | $0.03 par mégapixel |
| **Composition multi-références (1-14 refs)** | **Nano Banana Pro Edit** | `fal-ai/nano-banana-pro/edit` ✅ slug confirmé | Combine produit + décor + personnage sans "fuite" d'image de référence. | $0.15/image standard, $0.30/image en 4K (source fal.ai) |
| **Inpainting créatif / Replacement** | **FLUX.1 [pro] Fill** | `fal-ai/flux-pro/v1/fill` ✅ slug corrigé le 04/09 | Remplace une zone masquée par un objet complexe avec cohérence lumineuse. | $0.05 par mégapixel |
| **Rendu typographique / Logo / Texte** | **Ideogram V2 Edit** | `fal-ai/ideogram/v2/edit` ✅ vérifié le 04/09 (page officielle https://fal.ai/models/fal-ai/ideogram/v2/edit) | Rendu de texte incrusté et retouche avec contrôle prompt précis. | $0.08 par image |
| **Animation I2V Premium & Consistance Produit** | **Kling 3.0 Pro (Element Consistency)** | `fal-ai/kling-video/v3/pro/image-to-video` ✅ vérifié en production | Maintien parfait du produit (@Element1) sans dérive ni déformation. | ~$0.80 / clip 5s |
| **Animation I2V Produit (Subtile)** | **Kling 1.6 / 3.0 Standard** | `fal-ai/kling-video/v3/standard/image-to-video` ✅ vérifié en production | Mouvement fluide standard. **Obligation :** forcer `static camera` dans le prompt. | ~$0.45 / clip 5s |
| **Animation I2V Benchmark (Rapide)** | **Seedance Mini** | `fal-ai/seedance-mini` ✅ déjà utilisé côté Studio Pub | Validation de mouvement à bas coût avant rendu final Kling. | ~$0.15 / clip 5s |
| **Animation I2V Fluide / Liquides** | **MiniMax Video 01** | `fal-ai/minimax/video-01` ✅ vérifié le 04/09 (page officielle https://fal.ai/models/fal-ai/minimax/video-01) | Rendu physique des mouvements et vidéos Hailuo AI. | $0.50 par vidéo |
| **Restylisation Vidéo-à-Vidéo (4K)** | **Kling O3 V2V Edit** | `fal-ai/kling-video/o3/4k/video-to-video/edit` ✅ vérifié le 04/09 (page officielle https://fal.ai/models/fal-ai/kling-video/o3/4k/video-to-video/edit) | Restylise une vidéo en rendu 4K natif en 1 seule étape. | $0.42 par seconde ($2.10 pour 5s) |
| **Vidéo V2V Multimodale / Instructions** | **Gemini Omni Flash V2V** | `google/gemini-omni-flash/edit` ✅ slug corrigé le 04/09 (PAS de préfixe `fal-ai/`, PAS de `/v1.1/`) | Restylise une vidéo par instructions textuelles directes sans découpage. | Tarif au token : $1.875/1M tokens entrée, $21.875/1M tokens sortie, ≈$0.13/seconde en 720p |
| **Nettoyage Vidéo (Objet par Prompt)** | **Bria Video Eraser** | `bria/video/erase/prompt` ✅ corrigé le 04/09 (page officielle https://fal.ai/models/bria/video/erase/prompt — PAS de préfixe `fal-ai/`) | Supprime un élément mobile sur MP4 par prompt (version keypoints : `bria/video/erase/keypoints`). | $0.14 par seconde |
| **Upscaling Vidéo Final** | **RealESRGAN Video Upscaler** | `fal-ai/video-upscaler` ✅ corrigé le 04/09 (page officielle https://fal.ai/models/fal-ai/video-upscaler — ancien slug `fal-ai/re-esrgan/video-upscaler` était erroné) | Augmente la résolution vidéo trame par trame via RealESRGAN. | $0.0008 par mégapixel |

> [!NOTE]
> **Audit & Vérification Effectués le 04/09/2026** : 100% des endpoints, slugs et structures tarifaires de cette matrice ont été vérifiés individuellement en consultant les pages officielles et les schémas OpenAPI sur fal.ai. Tous les pièges de slug (`bria/video/erase/prompt` et `google/gemini-omni-flash/edit` sans préfixe `fal-ai/`, `fal-ai/video-upscaler` au lieu de `re-esrgan`) et les unités de facturation (par mégapixel vs par seconde vs par vidéo) sont désormais certifiés à jour.

---

## 3. Inventaire Détaillé des Modèles par Catégorie

### Catégorie A : Suppression d'Objets & Inpainting Déterministe

#### 1. `fal-ai/bria/eraser` (Remplacement & Nettoyage Pixel-Stricte)
* **Quand l'utiliser** : Suppression de mains, personnages, câbles, logos ou ombres parasites sur une photo réelle ou générée, lorsque le fond doit être reconstitué sans modifier l'objet voisin.
* **Ce qu'il fait** : Analyse le masque fourni et applique un inpainting contextuel localisé. Il ne touche à aucun pixel en dehors du masque.
* **Paramètres clés** :
  * `image_url` : URL de l'image source.
  * `mask_url` : Image masque (blanc = zone à effacer, noir = zone à conserver).
  * `mask_type` : `"manual"`.
* **Prompting** : Aucun prompt texte nécessaire (déterministe).

#### 2. `fal-ai/bria/background/remove` (Détourage Produit) — slug corrigé le 04/09
* **Quand l'utiliser** : Isoler un produit du sol ou du décor pour créer un PNG transparent.
* **Ce qu'il fait** : Extraction d'alpha matting haute précision sur les bords complexes (filets d'eau, plastiques transparents, tiges de plantes). Alternative si détails fins (cheveux) : `fal-ai/birefnet/v2`.

#### 3. `fal-ai/flux-pro/v1/fill` (Inpainting Créatif avec Remplacement) — slug corrigé le 04/09, prix $0.05/mégapixel
* **Quand l'utiliser** : Quand il ne faut pas seulement "effacer", mais **remplacer** un objet masqué par un autre (ex: remplacer une bouteille plastique par un flacon d'engrais organique dans la main).
* **Prompting** : Décrire uniquement l'objet qui doit apparaître DANS la zone masquée.

---

### Catégorie B : Édition d'Image & Modification Atomique

#### 1. `fal-ai/qwen-image-edit` (Édition Atomique à Sujet Fixe)
* **Quand l'utiliser** : Modification d'UN SEUL attribut (changer la couleur du bac, modifier le matériau du tuyau, changer le fond de cuisine en véranda).
* **Ce qu'il fait** : Maintient la géométrie exacte du produit principal tout en modifiant l'élément ciblé par la consigne textuelle.
* **Prompt Structure** :
  ```text
  Keep the main product [Describe Product] exactly unchanged. 
  Change only [Target Element] to [New State/Color/Texture].
  ```

#### 2. `fal-ai/flux-kontext` (Variations Contextuelles & Typographie)
* **Quand l me l'utiliser** : Extension de scène, variations d'angle léger, ou ajout d'annotations graphiques sur l'image.
* **Force** : Respecte les consignes de style et préserve la logique d'éclairage.

---

### Catégorie C : Composition Multi-Références & Édition Créative

#### 1. `fal-ai/nano-banana-pro/edit` (Gemini 3 Pro Image)
* **Quand l'utiliser** : Assemblage complexe nécessitant plusieurs images sources (ex: Photo du bac réels + Photo du personnage + Photo du décor de cuisine moderne).
* **Ce qu'il fait** : Supporte jusqu'à 14 images de référence distinctes. Harmonise la perspective, les ombres portées et le grain global.
* **Limitation** : Ne pas utiliser pour une simple suppression (utiliser `bria/eraser`).

#### 2. `fal-ai/nano-banana/edit` (Gemini Flash Image — Modèle Standard)
* **Quand l'utiliser** : Éditions créatives simples avec 1 seule image de référence et 1 instruction claire.
* **Consigne obligatoire** : Toujours structurer le prompt en 5 blocs (voir `Generateur_Prompts_Images.md`).

#### 3. Nano Banana 2 (Gemini 3.1 Flash Image) — ajouté au catalogue le 27/09/2026 (Claude Code, veille technologique)
* **Constat en l'ajoutant** : ce modèle est déjà le défaut validé du projet en pratique (mémoire `project_nano_banana_2_a_valider_fal`, 1 test concluant) mais **n'apparaissait pas encore dans ce catalogue** — trou de documentation corrigé ici.
* **Prix** : $0.08/image en 1K, $0.16/image en 4K (moitié moins cher que Nano Banana Pro à qualité comparable pour un cas simple).
* **Quand l'utiliser** : cas par défaut pour une édition/génération à 1 sujet clair, sans relation spatiale complexe entre plusieurs éléments — plus rapide et moins cher que la version Pro.
* **Quand préférer `nano-banana-pro/edit` à la place** : dès que la tâche demande un raisonnement spatial fin (vue en coupe avec plusieurs éléments imbriqués, comparatif avec texte intégré positionné précisément, scène lifestyle à plusieurs sujets/plans) — la Pro comprend mieux les relations spatiales et les intentions sémantiques, le double de prix reste marginal à l'échelle d'une fiche produit.

---

### Catégorie D : Animation Image-à-Vidéo (I2V)

#### 1. `fal-ai/kling-video/v3/pro/image-to-video` (Kling 3.0 Pro & Element Consistency — Défaut Studio Pub)
* **Quand l'utiliser** : Rendu final premium de toute animation publicitaire (Porte B Studio Pub) et démonstration produit où l'objet ne doit subir AUCUNE distorsion ni dérive d'identité.
* **Fonctionnalité Element Consistency** :
  * Paramètre `elements` : `[{"frontal_image_url": "...", "reference_image_urls": [...]}]` permettant d'ancrer 1 à 4 angles du produit.
  * Tag dans le prompt : `@Element1` (injecté automatiquement par `studio.providers.fal_client` si omis).
  * Payload : paramètre d'image de départ `start_image_url` (schéma v3 strict).
  * Option CLI : `--element-consistency` (actif par défaut dans `studio/cli.py create`).
* **Coût** : ~$0.80 pour un clip de 5s (~$0.16/s), max 10s.

#### 1bis. `fal-ai/kling-video/v1.6/standard/image-to-video` ou `v3/standard` (Secours Standard)
* **Quand l'utiliser** : Animation de scènes du guide d'utilisation (eau qui coule, gouttes de nutriments, ouverture de trappe).
* **RÈGLE CRITIQUE DE PROMPTING** : 
  * Le modèle a tendance à effectuer un travelling ou un zoom caméra non désiré.
  * **Toujours inclure** en début de prompt : `STATIC CAMERA, zero camera movement, locked tripod shot, close-up macro focus on [mechanism].`
  * Décrire le mouvement de l'élément mobile de façon continue : `Water flows continuously down from nozzle into reservoir.`

#### 2. `fal-ai/minimax/video-01` (Rendu physique des fluides)
* **Quand l'utiliser** : Si Kling échoue à rendre l'eau naturelle (effet de gel ou de plastique). MiniMax excelle dans la dynamique physique des liquides et des vapeurs.

#### 3. `fal-ai/seedance-mini` (Maquette & Validation Rapide)
* **Quand l'utiliser** : Tester 3 ou 4 idées d'animation rapidement avant d'engager les crédits sur Kling 1.6 ou Kling 3.0.

#### 4. ⚠️ NON TESTÉ EN PRODUCTION — H3 Max (repéré en veille le 27/09/2026, à valider avant usage)
* **Lancé par fal.ai le 01/09/2026** : post-entraînement du modèle open-weights MiniMax H3, classé #1 sur les benchmarks Artificial Analysis / Design Arena au moment de sa sortie.
* **Intérêt potentiel pour Studio Pub** : génère un clip de 5s en ~3s de calcul (~35x plus rapide que l'endpoint MiniMax H3 officiel). Tarif post-promo : $0.08/s en 768p (~$0.80 pour 10s).
* **À faire avant d'y confier une vraie pub** : un test comparatif qualité contre Kling 1.6 (référence production actuelle) — slug exact et comportement caméra non encore vérifiés ici, ne pas l'utiliser en aveugle sur un rendu final.

---

### Catégorie E : Vidéo-à-Vidéo (V2V) & Restylisation Directe

> [!NOTE]
> **Piste d'Optimisation de Pipeline** : La vidéo-à-vidéo permet de filmer une action réelle avec un téléphone portable (ex: verser de l'eau dans un bac en plastique quelconque) et de la convertir en une vidéo studio 3D/photoréaliste intégrée au décor du site en 1 seul appel API, évitant ainsi le découpage multi-phases (isolation → décor → geste → I2V).

#### 1. `fal-ai/kling-video/o3/4k/video-to-video/edit`
* **Entrée** : Une vidéo MP4 source + Un prompt de restylisation.
* **Sortie** : Une vidéo MP4 en 4K conservant le mouvement exact des mains et du fluide, mais appliquant le design du produit et le décor cible.

#### 2. `google/gemini-omni-flash/edit`
* **Entrée** : Vidéo MP4 + Instructions textuelles en langage naturel.
* **Usage** : Idéal pour transformer le style visuel tout en maintenant la synchronisation temporelle stricte. (Note: slug sans préfixe `fal-ai/`).

---

## 4. Protocole d'Essai & Enrichissement du Catalogue

Chaque fois qu'un nouveau modèle fal.ai est testé dans le cadre d'un chantier visuel :
1. **Consigner le test dans ce fichier** sous la section ci-dessous ("Historique des Benchmarks").
2. Indiquer la date, l'image/vidéo testée, le modèle utilisé, le résultat (Succès/Échec) et la leçon apprise.

### Historique des Benchmarks Validés

| Date | Cas d'Usage | Modèle Testé | Résultat | Leçon retenue |
|---|---|---|---|---|
| 04/09/2026 | Suppression personnage sur trappe d'eau réelle | `fal-ai/nano-banana/edit` | 🔴 Échec | Modèle génératif régénère le fond et déforme le réservoir. |
| 04/09/2026 | Suppression personnage sur trappe d'eau réelle | `fal-ai/bria/eraser` | 🟢 Succès Pixel | Suppression parfaite du personnage, mécanisme 100% conservé. |
| 03/09/2026 | Animation écoulement nutriments | `fal-ai/kling-video/v1.6/standard` | 🟢 Succès | Caméra stable obtenue après ajout de `static camera` au prompt. |
| 03/09/2026 | Vue en coupe technique du produit | `fal-ai/nano-banana/edit` (v12) | 🟢 Succès | Nécessite 2 itérations pour caler la transparence du réservoir. |
| 05/09/2026 | Ajout poche vide + racines insérées, étape plantation (2 références : image de base + photo produit studio) | `fal-ai/nano-banana/edit` (standard) | 🔴 Échec | Le geste demandé (racines entrant dans la poche) n'a pas été respecté ET un logo "Cultivez Facilement" a fui depuis la référence produit vers l'image finale, sans avoir été demandé. → règle ajoutée : 2+ références = `nano-banana-pro/edit`, jamais le standard. |
| 05/09/2026 | Suppression tomate parasite sur 2 images finales (1 seule image en entrée à chaque fois) | `fal-ai/nano-banana/edit` (standard) | 🟢 Succès | Consigne en langage naturel simple, sans masque, a suffi sur les 2 cas — confirme que le standard reste adapté pour une édition à 1 seule image d'entrée. |
| 24/10/2026 | Génération de 8 visuels studio & lifestyle SneakSafe (variante Gris chenille côtelée + embouts filet bleu clair, macro chenille 360°, comparatif versus filet générique, 3 étapes How-To, scène famille) ancrés sur les vraies photos fournisseur AliExpress (`1005009225688116`) | `fal-ai/nano-banana-pro/edit` | 🟢 Succès (8/8 du 1er coup) | L'ancrage multi-références (`image_urls` combinant la photo réelle du fournisseur AliExpress + la photo débrandée de la sneaker) maintient à 100 % la texture chenille côtelée et la géométrie du zip sous fourreau élastique sans aucune dérive ni texte chinois parasite. |
| 24/10/2026 | Génération de 2 vidéos de démonstration SneakSafe (insertion chaussure dans chenille 360° + rotation tambour machine inox) et intégration native Shopify/Dropmagic | `fal-ai/kling-video/v1.6/standard/image-to-video` (+ `v3/pro/image-to-video` vérifié `HTTP 200`) | 🟢 Succès (`10/10` audit trames, `< 0,40 Mo`) | Caméra fixe obtenue avec `STATIC CAMERA, locked tripod shot`. Post-traitement obligatoire `ffmpeg -c:v libx264 -crf 26 -preset slow -an -movflags +faststart` (`0,40 Mo` et `0,32 Mo`). **Règle d'intégration Dropmagic (`dm-image-text-2` / `dm-how-to-1`) découverte le 25/10 :** le champ `image_media_video` (`type: "text"`) découpe l'URL sur `?` et n'active la lecture automatique en boucle que si l'URL se termine exactement par `?loop=true&autoplay=true&muted=true&playsinline=true` (ex: `https://cdn.shopify.com/s/files/.../video.mp4?loop=true&autoplay=true&muted=true&playsinline=true`). Si on laisse `?v=17928...`, Dropmagic génère un `<video>` sans attribut `autoplay` ni `muted`. |
