🎮 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 faire intervenir des 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.

Aucune clé d'API ne vit dans votre projet : l'appel part de l'application vers les serveurs Celestory, qui portent eux-mêmes la facturation auprès du fournisseur du modèle. C'est une bonne nouvelle pour la sécurité, et la raison pour laquelle tout ce que déclenche un joueur est décompté sur vos crédits.

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

⚠️ Ces deux blocs sont réservés à l'offre Compte organisation (Business). Sur un compte Pro ou en essai gratuit, ils ne s'exécutent pas — et sans message d'erreur. Voir Les crédits IA et l'abonnement.

🟦 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

🔺 Il n'y a pas d'entrée « historique ». Chaque appel part seul, sans mémoire des échanges précédents. Si vous voulez qu'un PNJ se souvienne, c'est à vous d'accumuler les répliques dans une variable texte et de la concaténer au prompt.

🔺 Aucun réglage de longueur de réponse n'existe. La seule façon de la borner est de l'écrire dans la consigne (« 120 mots au maximum »).

📤 Sorties

🔺 Il n'existe aucune sortie « si erreur ». Contrairement au bloc Baserow, le bloc Requête IA ne propose aucun chemin dédié à l'échec : réseau coupé, quota épuisé, modèle indisponible — le scénario continue par out comme si de rien n'était. Pire, pour le bloc texte, le message d'erreur du serveur devient résultat et peut s'afficher au joueur comme une vraie réponse. C'est le piège central de ce bloc : il est détaillé, avec les parades, dans Le bloc Requête IA : ce qu'il ne vous dira pas.

Modèles texte disponibles en jeu

La liste est fermée : deux modèles, pas de saisie libre. Les appels passent par les serveurs Celestory, qui les routent vers fal, lequel s'appuie sur OpenRouter (un service qui donne accès à de nombreux modèles d'IA depuis une seule interface).

🔺 Réglez le point modèle explicitement — ne laissez pas le défaut décider pour vous.

💡 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 ? »
2. Le texte est transmis à l'entrée prompt du bloc Requête IA texte.
3. Le prompt système est configuré : « Marchand rusé qui exagère la valeur de ses objets et répond en rimes. Réponds en 40 mots maximum. »
4. La température est baissée à 0,7 : assez vivante pour un marchand, assez stable pour rester jouable.
5. Le bloc continue par out, et résultat part vers une condition qui teste si le texte est vide ou s'il ressemble à un message technique.
6. Si le texte est valide, il s'affiche : « Des trésors rares, mon ami ! Une épée qui brille comme le jour, ou une potion qui guérit d'amour ! » Sinon, une réplique de repli écrite à la main prend le relais.

🔺 L'étape 5 n'est pas une précaution de confort : c'est le seul filet de sécurité qui existe, puisque le bloc n'a pas de sortie d'erreur.

⚙️ Détails techniques

• Température à exactement 0 : ne le faites pas. Le serveur traite un 0 comme « rien n'a été réglé » et le remplace silencieusement par 0,5. Pour un comportement quasi déterministe, utilisez 0,1.
• Validation de quota : avant chaque génération, le serveur vérifie que le créateur n'a pas dépassé sa limite mensuelle. Si le quota est atteint, l'appel est refusé — et, pour le bloc texte, ce refus atterrit dans résultat.
• Longueur du prompt : tout ce que vous concaténez (historique maison, données de contexte) est envoyé à chaque appel et consomme des tokens. Bornez-le.

---

🟦 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

🔺 Comme pour le bloc texte, aucune sortie « si erreur ». La différence : ici, un échec ne produit pas un faux texte mais une image vide. Testez résultat avant de l'afficher, sinon le joueur voit un trou dans l'écran.

Modèles image disponibles en jeu

🔺 Ces noms sont ceux de la liste du bloc, pas ceux de l'atelier Génération IA de l'éditeur : les modèles proposés en jeu sont volontairement plus restreints (et moins chers) que ceux du panneau créateur.

💡 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 »
2. Le texte est transmis à l'entrée prompt du bloc Requête IA image.
3. Le modèle reste sur fal-ai/flux-2/klein/4b, le prompt négatif contient « texte, filigrane, cadre ».
4. Prévoyez un écran d'attente : la génération prend plusieurs secondes et le joueur n'a aucun retour pendant ce temps.
5. Le bloc continue par out, et une condition teste si résultat est vide.
6. Si l'image existe, elle part vers un bloc d'affichage d'image. Sinon, une illustration de secours stockée dans le projet prend sa place.

⚙️ Détails techniques

• Performances et coûts : la génération d'images est plus lente et plus chère que le texte. Prévoyez des écrans de chargement fluides et surveillez les quotas.
• Validation de quota : identique à la requête texte — vérification avant chaque génération.
• Repli obligatoire : puisqu'aucun signal d'erreur n'existe, la seule gestion possible est une condition sur résultat suivie d'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, jamais dans ceux du joueur (qui n'en a pas).

Les requêtes en jeu sont comptées beaucoup plus finement que les générations de l'éditeur :

Autrement dit, avec le quota de 30 crédits/mois de l'offre Compte organisation, un jeu peut absorber quelques centaines de requêtes image ou quelques milliers de requêtes texte par mois — mais pas un usage illimité. Le détail des paliers est dans Les crédits IA et l'abonnement.

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. Rien ne le fait à votre place, et un joueur qui relance un dialogue en boucle consomme votre quota.
2. Utiliser des prompts stricts : contraignez l'IA avec des prompts système précis (cf. les Prompts de compétence de la documentation Créateur) pour encadrer les réponses.
3. Monitorer la consommation : suivez les générations dans l'onglet Générations de la fenêtre Génération IA, filtrable par source « en jeu », et la jauge « Utilisation mensuelle » en haut du panneau.
4. Choisir le modèle adapté : mistralai/ministral-3b-2512 pour les interactions fréquentes, google/gemini-2.5-flash pour les moments qui exigent de la rigueur.
5. Toujours tester résultat avant de vous en servir. C'est la seule gestion d'erreur possible : il n'y a pas de sortie « si erreur » à câbler. Ne faites jamais partir résultat directement vers un écran ou vers une écriture en base.

---

→ Pour aller plus loin : Le bloc Requête IA : ce qu'il ne vous dira pas · Génération IA — Côté Créateur · Lexique IA