🎮 AI Generation — Player Side

Celestory combines the power of nocode (creating applications without writing code) and vibe coding (describing what you want in plain language and letting the AI generate the code) to test the best AI models — including sovereign models (developed in Europe or open source, independent of US tech giants) like Mistral (text) or Flux (image) — directly in your player experiences. Once models are validated in the Cloud, you can download them for local execution.

General Principles

During an experience (game, narrative application, serious game, training module…), the player can interact directly with AI engines configured by the creator, thanks to two dedicated blocks available in the graph:

• 🟦 AI text request block — Dynamic text generation
• 🟦 AI image request block — On-the-fly image generation

🟦 AI text request block

The AI text request block connects your scenario to language models (LLMs — AI programs capable of understanding and generating text, like a very advanced virtual assistant) to generate dynamic and contextual responses in real time.

📥 Inputs

📤 Outputs

Text Models Available In-Game

The creator can configure one of the following models (via OpenRouter, a service that provides access to many different AI models from a single interface):

💡 Use Case Example

Scenario: Dialogue with a traveling merchant

1. The player interacts via a Text Input block: « What do you have for sale? »
2. The text is passed to the Prompt input of the AI text request block.
3. The Role is configured: « Sly merchant who exaggerates the value of his items and answers in rhymes ».
4. The History contains previous exchanges to maintain dialogue continuity.
5. On Success, the response is displayed: « Rare treasures, my friend! A sword that glows like day, or a potion that heals in every way! »
6. The flow continues according to the player's choices.

⚙️ Technical Details

• Token Management: History consumes tokens (text units treated by the AI — "hello" = 1 token, a sentence ≈ 13 tokens). Limit it to recent and relevant exchanges to optimize costs.
• Quota Validation: Before each generation, the server checks that the creator has not exceeded their monthly generation limit. If the quota is reached, an AI_GENERATION_LIMIT_REACHED error is returned.
• Latency and Moderation: Errors can occur in case of too long response delay or content blocked by moderation filters.

🟦 AI image request block

The AI image request block allows for the transformation of textual descriptions into dynamically generated images, integrated at the heart of the interactive experience.

📥 Inputs

📤 Outputs

Image Models Available In-Game

💡 Use Case Example

Scenario: Creating a personalized fantasy landscape

1. The player is asked to describe a location via a Text Input block: « An enchanted forest with golden-leaved trees and a crystal river under a purple sky »
2. The text is passed to the Prompt input of the AI image request block.
3. The model is configured to Nano Banana for fast generation.
4. A loading indicator is displayed during generation (~10 seconds).
5. On Success, the Image URL is retrieved and passed to an Image Display block.
6. The generated image is displayed on the screen for the player.

⚙️ Technical Details

• Performance and Costs: Image generation is resource-intensive. Plan for smooth loading screens and monitor AI quotas.
• Quota Validation: Same as text request — check before each generation.
• Error Handling: The Error signal allows for an alternative (retrying or displaying a default image).

⚠️ AI Credit Consumption

Crucial aspect of the AI usage model in player experience:
Any request sent from the experience — whether it's an AI text request or AI image request block triggered by a player's action — draws directly from the Creator's monthly AI credits.

Creator Responsibilities

1. Limit and Secure Requests: Limit the number of possible requests per session, per player, or per scene to avoid abuse.
2. Use Strict Prompts: Constrain the AI with precise Role/System Prompts (see Competency Prompts in the Creator documentation) to frame responses.
3. Monitor Consumption: Track spending and token consumption in the Previous generations tab (filterable by "in-game" source) and in the main quota counter.
4. Choose the Right Model: Opt for lightweight models (ministral-3b, Nano Banana) for frequent interactions, and reserve premium models for key moments.
5. Handle Errors Gracefully: Systematically use the Error output of AI blocks to provide fallback behaviors (pre-defined responses, default images).

Updated on: 28/07/2026