AI Scenario
What is an AI Scenario?
The AI Scenario is the narration script that drives your video. When you generate a video, AI reads your entire document - text blocks, headings, code, tables, and screenshots - and creates a structured script that narrates each step of your tutorial.
How it works
The scenario generation uses an advanced AI language model to:
- Analyze document structure - identify the logical flow of steps, sections, and key information
- Interpret screenshots - understand what each screenshot shows and how it relates to the surrounding text
- Write narration - create natural-sounding narration text for each slide, matching the tutorial tone
- Set timing - assign duration and pacing for each slide based on content complexity
Scenario structure
The AI generates a scenario with slides. Each slide contains:
| Field | Description |
|---|---|
| Narration text | What the TTS voice will say for this slide |
| Screenshot reference | Which screenshot to display |
| Duration | How long the slide is shown (driven by audio length) |
| Transition | How the slide enters/exits |
Tips for better scenarios
- Write clear headings - Headings help AI understand the tutorial structure. Use them to mark distinct steps or sections.
- Add descriptive text - The more context you provide around screenshots, the better the AI narration. Brief captions or explanations significantly improve output.
- Use logical ordering - Arrange blocks in the order you want them narrated. AI follows the document flow top to bottom.
- Keep screenshots focused - Crop screenshots to show only the relevant area. AI narration is more precise when screenshots are focused.
ℹ️ Info: A document can have at most 30 blocks for video generation - split longer guides into parts. Focused documents produce the best narration quality.
Language handling
The narration language is set when you start generation, not determined by the document text. The AI will:
- Generate narration in the selected language regardless of the document language
- Handle mixed-language documents (e.g., English UI with Polish explanations)
- Maintain natural prosody and pacing in the target language
ℹ️ Info: Special characters, including Polish diacritics, are fully supported.
Can I edit the AI scenario before rendering?
Currently, the scenario is generated and rendered in a single pipeline. To change the narration, edit your document content and regenerate.
Why does the narration not match my text exactly?
AI rewrites your content into spoken narration. It paraphrases, simplifies, and adds transitions to create a natural video flow. The meaning is preserved.
What AI model is used?
The scenario is generated by an advanced AI language model, selected for narration quality.
What if the AI generates incorrect narration?
If the narration is inaccurate, try adding more descriptive text to your document. The AI relies on context - more detail produces better results.