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

# 🤳 Génération IA joueur

# 🎮 Génération IA — Côté Joueur
Celestory permet d'allier la puissance du nocode (création d'applications sans écrire de code) et du vibe coding (décrire en français ce que l'on veut et laisser l'IA générer le code) pour tester les meilleurs modèles d'IA — y compris des modèles souverains (développés en Europe ou en open source, indépendants des plateformes américaines) comme Mistral (texte) ou Flux (image) — directement dans vos expériences joueur. Une fois les modèles validés en Cloud, vous pouvez les télécharger pour une exécution locale.
---
## Principes généraux
Au cours d'une expérience (jeu, application narrative, serious game, module de formation…), le joueur peut interagir directement avec des moteurs d'IA configurés par le créateur, grâce à deux blocs dédiés disponibles dans le graphe :
- 🟦 Bloc Requête IA texte — Génération de texte dynamique
- 🟦 Bloc Requête IA image — Génération d'images à la volée
---
## 🟦 Bloc Requête IA texte
Le bloc Requête IA texte connecte votre scénario à des modèles de langage (LLM — programmes d'IA capables de comprendre et générer du texte, comme un assistant virtuel très avancé) pour générer des réponses dynamiques et contextuelles en temps réel.
### 📥 Entrées
### 📤 Sorties
### Modèles texte disponibles en jeu
Le créateur peut configurer l'un des modèles suivants (via OpenRouter, un service qui donne accès à de nombreux modèles d'IA différents depuis une seule interface) :
### 💡 Exemple d'utilisation
Scénario : Dialogue avec un marchand ambulant
1. Le joueur interagit via un bloc Saisie de texte : « Que proposes-tu à la vente ? »
1. Le texte est transmis à l'entrée Prompt du bloc Requête IA texte.
1. Le Rôle est configuré : « Marchand rusé qui exagère la valeur de ses objets et répond en rimes ».
1. L'Historique contient les échanges précédents pour maintenir la continuité du dialogue.
1. Sur Succès, la réponse est affichée : « Des trésors rares, mon ami ! Une épée qui brille comme le jour, ou une potion qui guérit d'amour ! »
1. Le flux continue selon les choix du joueur.
### ⚙️ Détails techniques
- Gestion des tokens : L'historique consomme des tokens (unités de texte que l'IA traite — « bonjour » = 1 token, une phrase ≈ 13 tokens). Limitez-le aux échanges récents et pertinents pour optimiser les coûts.
- Validation de quota : Avant chaque génération, le serveur vérifie que le créateur n'a pas dépassé sa limite mensuelle de générations. Si le quota est atteint, une erreur AI_GENERATION_LIMIT_REACHED est renvoyée.
- Latence et modération : Les erreurs peuvent survenir en cas de délai de réponse trop long ou de contenu bloqué par les filtres de modération.
---
## 🟦 Bloc Requête IA image
Le bloc Requête IA image permet de convertir des descriptions textuelles en images générées dynamiquement, intégrées au cœur de l'expérience interactive.
### 📥 Entrées
### 📤 Sorties
### Modèles image disponibles en jeu
### 💡 Exemple d'utilisation
Scénario : Création d'un paysage fantastique personnalisé
1. Le joueur décrit un lieu 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 est transmis à l'entrée Prompt du bloc Requête IA image.
1. Le modèle est configuré sur Nano Banana pour une génération rapide.
1. Un indicateur de chargement s'affiche pendant la génération (~10 secondes).
1. Sur Succès, l'URL de l'image est récupérée et passée à un bloc Affichage d'image.
1. L'image générée s'affiche à l'écran pour le joueur.
### ⚙️ Détails techniques
- Performances et coûts : La génération d'images est gourmande en ressources. Prévoyez des écrans de chargement fluides et surveillez les quotas IA.
- Validation de quota : Identique à la requête texte — vérification avant chaque génération.
- Gestion des erreurs : Le signal Erreur permet de proposer une alternative (réessayer ou afficher une image par défaut).
---
## ⚠️ Consommation des crédits IA
Aspect crucial du modèle d'utilisation de l'IA en expérience joueur :
Toute requête envoyée depuis l'expérience — qu'il s'agisse d'un bloc Requête IA texte ou Requête IA image déclenché par l'action d'un joueur — puise directement dans les crédits IA mensuels du Créateur.
### Responsabilités du créateur
1. Borner et sécuriser les requêtes : Limitez le nombre de requêtes possibles par session, par joueur ou par scène pour éviter les abus.
1. Utiliser des prompts stricts : Contraignez l'IA avec des Rôles/System Prompts précis (cf. les Prompts de compétence de la documentation Créateur) pour encadrer les réponses.
1. Monitorer la consommation : Suivez les dépenses et la consommation de tokens dans l'onglet Générations précédentes (filtrable par source « en jeu ») et dans le compteur de quota principal.
1. Choisir le modèle adapté : Optez pour des modèles légers (ministral-3b, Nano Banana) pour les interactions fréquentes, et réservez les modèles premium pour les moments clés.
1. Gérer les erreurs gracieusement : Utilisez systématiquement la sortie Erreur des blocs IA pour prévoir des comportements de repli (réponses pré-définies, images par défaut).