> ## Documentation Index
> Fetch the complete documentation index at: https://docs.argil.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Story - Build an entire mini-film or ad

> Build a multi-scene video from a single prompt

## What is Story?

Story lets you generate a multi-scene video from a single prompt. You describe what you want, and Argil automatically breaks it into a sequence of scenes with their own camera angles, timing, and actions. The result is a continuous video of up to 15 seconds, perfect for product ads, short clips, or cinematic social content.

## How it works

1. **Describe your video** — Write a single prompt describing the full sequence you want (e.g., "A penguin leaving its group to reach the promised mountain.")
2. **Add references** (optional) — Upload a first frame image or add reference images to guide the visual style.
3. **Generate scenes** — Argil splits your prompt into separate scenes (typically 2 to 4), each with its own detailed description, camera movement, and timing.
4. **Review and edit** — Adjust each scene's text, add/remove scenes manually. Each scene can be set between 3s and 15s.
5. **Generate** — Hit Generate to render the full sequence in one go.

You can also click **Write scenes manually** to skip the auto-split and write each scene yourself from scratch.

## Settings

| Setting      | Options                            |
| ------------ | ---------------------------------- |
| Model        | Kling 3.0 Pro / Kling 3.0          |
| Aspect ratio | 9:16 (Portrait) / 16:9 (Landscape) |
| Sound        | On / Off                           |

## Reference limits

You can attach image or video references to guide the output. Here are the constraints:

| Condition                      | Limit                                     |
| ------------------------------ | ----------------------------------------- |
| Image references only          | Up to 7 images per video                  |
| When a video reference is used | Up to 4 references total (video included) |
| Video references               | 1 video max per generation                |

**Image requirements:** minimum 300 × 300 px, maximum 10 MB.

**Video requirements:** between 3 and 10 seconds long, 720p to 2160p resolution, 24 to 60 FPS, maximum 200 MB.

## Tips

* Keep your initial prompt focused on a clear narrative arc — Argil handles the scene breakdown best when there is a logical progression (setup, action, resolution).
* Use the first frame option to lock the opening shot's composition and style.
* After scene generation, review each scene's camera direction and adjust if the transitions feel too abrupt.
* Shorter scenes (3s) work well for quick cuts; longer scenes (5-10s) suit slow, cinematic shots.

## FAQ

<AccordionGroup>
  <Accordion title="How many scenes can I create?">
    You can create up to 6 scenes, or a total of 15 seconds' worth of scenes. Since each scene ranges from 3 to 15 seconds, you will typically get 2 to 4 scenes.
  </Accordion>

  <Accordion title="Can I reorder or delete individual scenes?">
    Yes. After Argil generates the scene breakdown, you can edit any scene's prompt, delete a scene using the trash icon, or add a new scene with the "+ New scene" button.
  </Accordion>

  <Accordion title="Can I use avatars or image references inside scenes?">
    You can add reference images and a first frame at the bottom of the Story editor. Use the @ symbol in your prompt to reference avatars or uploaded images directly.
  </Accordion>

  <Accordion title="What happens if my reference image or video does not meet the requirements?">
    You will see an error message explaining the issue (file too large, resolution too low, video too short/long, etc.). Resize or re-export your file to match the limits listed above and try again.
  </Accordion>
</AccordionGroup>