> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://documentation.celestory.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# ⬜ Requête IA image

# ⬜ Requête IA image

![Requête IA image](https://celestory-docs-illustrations.netlify.app/fr/RequeteIAimage_FR.svg)

Le bloc Génération d'image par IA permet de convertir des descriptions textuelles en images générées dynamiquement via des modèles d'Intelligence Artificielle intégrés. Il transforme des prompts narratifs ou des saisies utilisateur en visuels uniques, adaptés aux choix créatifs ou aux interactions du public.

Ce bloc est idéal pour enrichir des expériences interactives avec des éléments visuels personnalisés, comme des avatars, des décors ou des objets magiques, sans nécessiter de ressources graphiques préexistantes.

## 📥 Entrées

-   prompt (Texte) : Description textuelle détaillée de l'image à générer (ex: "Un chat volant dans l'espace en style pixel art futuriste cyberpunk"). Plus le prompt est précis, plus le résultat sera fidèle à la demande.
-   prompt négatif (Texte) : Éléments à exclure de la génération (ex: "flou, texte, membres déformés").
-   modèle (Choix, défaut `fal-ai/flux-2/klein/4b`) : Modèle de génération d'image à utiliser. Valeurs disponibles : `fal-ai/flux-2/klein/4b` et `fal-ai/flux-2/klein/4b/base/edit`.
-   image (Image - visible uniquement si le modèle sélectionné est `fal-ai/flux-2/klein/4b/base/edit`) : image de référence à éditer/transformer.

## 📤 Sorties

-   résultat (Image) : Donnée image générée (URL et métadonnées), utilisable directement dans un bloc d'affichage d'image ou de fond.

## 💡 Exemple d'utilisation

Scénario : Création d'un paysage fantastique personnalisé

1. Le joueur est invité à décrire un lieu magique via un bloc Saisie de texte : "Une forêt enchantée avec des arbres aux feuilles dorées et une rivière de cristal sous un ciel violet".
1. Le texte saisi est transmis à l'entrée prompt du bloc Requête IA image.
1. Le prompt négatif est réglé sur "flou, texte, filigrane" et le modèle est laissé sur sa valeur par défaut.
1. Le bloc est activé, et un indicateur de chargement s'affiche pendant la génération.
1. Le résultat est récupéré et passé à un bloc Affichage d'image pour montrer le paysage généré à l'écran.

## ⚙️ Détails Techniques

-   Performances et coûts : La génération d'images est un processus gourmand en ressources. Prévoyez des états de chargement fluides ("Création en cours...") et surveillez les quotas IA définis dans votre compte créateur.
-   Modèles disponibles : la liste déroulante du modèle propose actuellement deux valeurs fixes (`fal-ai/flux-2/klein/4b` et `fal-ai/flux-2/klein/4b/base/edit`) ; ce dernier fait apparaître automatiquement l'entrée image.

---

*Version documentée : v2*