> For the complete documentation index, see [llms.txt](https://mazingxr.gitbook.io/mazing-world/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mazingxr.gitbook.io/mazing-world/ai-apps/ai-video-app.md).

# AI Video App

Upload a start frame, describe the motion you want – and the AI turns it into a video. Optionally add an end frame, and the video will transition from the start frame to the end frame.

{% hint style="info" %}
Video generation can take a few minutes. You can close this page in the meantime and come back later - your video will be waiting for you when it's done.
{% endhint %}

<figure><img src="https://3497237590-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWzFDCBJYsAI1jsAj4WvF%2Fuploads%2F4zyskSwmSBI8uGgb0qkM%2Fimage.png?alt=media&amp;token=d88ca648-e691-4946-8940-aa8db9a1450e" alt=""><figcaption></figcaption></figure>

### Start and End Frame

* **Start Frame** (required): the image your video starts with.
* **End Frame** (optional): an image your video should end on. Leave it empty to let the AI animate freely from the start frame.

Images can be uploaded directly or picked from your product library.

### Video Description

In the text field, describe the motion, camera movement, and mood the video should have - e.g. *"Camera slowly pushes in, soft light from the left"*.

Use the magic wand button next to the field to have the AI automatically improve your prompt.

<figure><img src="https://3497237590-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWzFDCBJYsAI1jsAj4WvF%2Fuploads%2FrloON5PuzxzdKgG5BCzE%2Fimage.png?alt=media&amp;token=9e652564-bd90-4e16-b9be-75a8d3f08759" alt=""><figcaption></figcaption></figure>

### Settings

#### Quality / Resolution

Choose between **480p, 720p, 1080p, 2k, and 4k**. Higher resolutions mean more detail, but also a slightly longer generation time.

#### Duration

Video length is selectable between **5 and 10 seconds**.

{% hint style="info" %}
Aspect ratio is currently taken automatically from the start frame and can't be set separately.
{% endhint %}

### Shots

A video project (a "session") can consist of multiple **shots** - e.g. several variations or scenes you generate one after another.

* **New Shot**: adds another, empty shot.
* Switch between shots by clicking them in the strip below.
* A shot can be deleted as long as it isn't currently generating.

<figure><img src="https://3497237590-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWzFDCBJYsAI1jsAj4WvF%2Fuploads%2FN4jHwvaIr3tSW6URye5F%2Fimage.png?alt=media&amp;token=557c3ef1-050b-4460-83ab-a929ae6942df" alt=""><figcaption></figcaption></figure>

### Preview vs. Full Generation

|                   | Preview                  | Generate Video  |
| ----------------- | ------------------------ | --------------- |
| Cost              | 0.5 credits              | 5 credits       |
| Quality           | always lowest resolution | as configured   |
| Saved             | no                       | yes, to History |
| Tab can be closed | no                       | yes             |

The **Preview** is meant for quickly and cheaply checking whether the motion between the start and end frame looks the way you want, before running the full (more expensive) generation.

{% hint style="warning" %}
Please don't navigate away while a preview is generating - it isn't saved anywhere, so the result would be lost.
{% endhint %}

### Generating a Video

Click **"Generate shot \[number]"**. Generation runs server-side in the background, so while it's running you can:

* keep working on another shot,
* leave the page and come back later,
* close the app entirely - the video will be waiting, finished, in your History.

While a shot is generating, the preview area shows a loading indicator instead of the result.

### Sessions

Use the **"Sessions"** button in the top right to reopen previous or currently running video sessions - including all shots, results, and the original input images.

Once a session is open or a result exists, a **"New session"** button appears next to it, letting you start over from scratch.

<figure><img src="https://3497237590-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWzFDCBJYsAI1jsAj4WvF%2Fuploads%2F4kuv7Zo4HRt3LjXi1yJP%2Fimage.png?alt=media&amp;token=7ec967b6-f670-4f06-8cea-d389425a2079" alt=""><figcaption></figcaption></figure>

### History

The History shows every video you've generated, along with its input image(s), prompt, aspect ratio, duration, and quality. From there you can:

* download the finished video,
* reuse the same inputs again in the AI Video App ("Reuse All Inputs"),
* bring an image from History or the Product Library directly into the AI Video App as a new shot (via the *"Reuse"* / *"Use product in App"* button → *"Open in AI Video"*).

<figure><img src="https://3497237590-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWzFDCBJYsAI1jsAj4WvF%2Fuploads%2F7dZP8agQwwmqz9rc8wLv%2Fimage.png?alt=media&amp;token=7fd20931-9bfa-430c-8e6a-2399f93c6c24" alt=""><figcaption></figcaption></figure>
