> For the complete documentation index, see [llms.txt](https://docs.theseaai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.theseaai.com/video/video-overview.md).

# Video overview

Create, compare, and export videos in Beachside.

{% hint style="danger" %}
Video is in early access and may not function as expected.
{% endhint %}

Video Playground lets you animate visuals directly in Beachside, on the same surface where your image work lives.

#### From a single image

<figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2FwePy0T4DvnM3qJxXSEHm%2Fsingle-image.gif?alt=media&amp;token=4a6ded3b-526c-410d-8097-1f31cce019ab" alt=""><figcaption></figcaption></figure>

#### From first to last frame

<figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2FZdYVvyiTVqlnGDL1s4Xk%2Ffirst-to-last.gif?alt=media&amp;token=532fc848-f60d-4fef-a012-6b0a80e6b055" alt=""><figcaption></figcaption></figure>

<details>

<summary><strong>Download the video examples</strong></summary>

{% file src="/files/JJJzf5p9hZQerSVOrc2p" %}

{% file src="/files/xh0IsChpCJ3KkO2lBDLM" %}

</details>

<details>

<summary><strong>Assets</strong></summary>

{% file src="/files/XowDBrdHVl4CCoc2MsLg" %}

> **Single frame**
>
> ```
> A glossy drop of blue nail polish falls vertically in slow motion toward a blue surface in front of a Plage nail polish bottle. 
> The drop lands near the bottle, triggering a dynamic splash of thick blue liquid that curls upward around the bottle. The bottle remains completely dry and untouched. 
> The splash ripples and slowly settles back into a sleek, reflective liquid pool. High-end cosmetic product aesthetic, vibrant cobalt blue studio background, smooth slow-motion physics, lighting highlights on gold cap and glossy textures.
> ```

> **First and last frame**
>
> ```
> The scene opens overhead, directly above the Desiaqua bottle: a pure top-down view of the matte black cap, centered in frame, surrounded by fine golden sand sculpted into concentric ripple rings. Warm amber light rakes across the texture. Everything is still.
> The camera begins a slow, fluid descent and rotation — unhurried, cinematic — tilting from overhead to a low three-quarter side angle, gradually revealing the full bottle: clear glass filled with deep amber liquid, the Desiaqua Aqua Oasis lettering catching the warm light, the bottle resting at a slight angle nestled in golden sand dunes.
> The bottle never moves. Only the world around it breathes. As the camera moves, a soft desert wind stirs — fine sand particles lift and drift lazily across the surface, catching the backlight as golden dust. The light shifts subtly, a warm golden ray sweeping slowly across the dunes, deepening shadows on one side, igniting the amber liquid from within.
> The movement is barely perceptible — a whisper of wind, a breath of light. The sand settles as the camera reaches its final position, holding on the full product side view.
> Camera: smooth orbital move from 90° overhead to approximately 20° elevation side angle. No shake, no cuts.
> Speed: extremely slow. Full move takes 8–10 seconds of real time.
> Lighting: warm golden hour. Strong directional side light. Soft glowing backlight through the amber liquid.
> Mood: desert luxury, meditative, cinematic. Silence and stillness with the gentlest signs of life.
> ```

</details>

***

## How to use

{% @arcade/embed flowId="kokPZH6OlCsqLEN3dsjR" url="<https://app.arcade.software/share/kokPZH6OlCsqLEN3dsjR>" %}

{% tabs %}
{% tab title="Single image" %}

## Single image

Animate one existing visual. Use this mode when you have an approved key visual and want to bring it into motion.

{% stepper %}
{% step %}

#### Open a Video Playground

From the Playgrounds page, create a new Video Playground. You can also send any image directly to a new or existing Video Playground from the Gallery or from an image playground.
{% endstep %}

{% step %}

#### Select "Single image" mode

<kbd><mark style="color:$primary;">**Single image**<mark style="color:$primary;"></kbd> is the default mode. Upload your image by selecting the image area or dropping a file in.
{% endstep %}

{% step %}

#### Write a prompt

Describe how you want the image to move. A text model can help write a clear prompt.
{% endstep %}

{% step %}

#### Add reference images (optional)

Add up to 3 reference images to guide the visual style of the output. References work the same way as in the image playground.
{% endstep %}

{% step %}

#### Set aspect ratio and duration

Choose an aspect ratio: **Landscape (16:9)** or **Portrait (9:16)**.

Choose a duration: **4 seconds** (default), **6 seconds**, or **8 seconds**.

{% hint style="info" %}
Some models may not support all settings. When that's the case, a note appears below the control: "Some models may ignore this setting."
{% endhint %}
{% endstep %}

{% step %}

#### Generate

Select <kbd><mark style="color:$primary;">**Generate**<mark style="color:$primary;"></kbd>. You will be taken to the canvas. Each model generates one version of your video, and versions appear on the canvas as they finish.
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="First to last frame" %}

## First to last frame

Control exactly how the video starts, ends, or both. Use this mode when you know the opening and closing frames and want the model to generate the motion between them.

{% stepper %}
{% step %}

#### Open a Video Playground

From the Playgrounds page, create a new Video Playground.
{% endstep %}

{% step %}

#### Select "First to last frame" mode

Select <kbd><mark style="color:$primary;">**First to last frame**<mark style="color:$primary;"></kbd> in the mode selector.

Upload a start image, an end image, or both. The model generates the transition between them.

{% hint style="info" %}
If you already uploaded an image in Single image mode and then switch to First to last frame, that image becomes the start frame automatically.
{% endhint %}
{% endstep %}

{% step %}

#### Write a prompt

Describe the motion you want between the two frames.
{% endstep %}

{% step %}

#### Set aspect ratio and duration

Choose an aspect ratio: **Landscape (16:9)** or **Portrait (9:16)**.

Choose a duration: **4 seconds** (default), **6 seconds**, or **8 seconds**.
{% endstep %}

{% step %}

#### Generate

Select <kbd><mark style="color:$primary;">**Generate**<mark style="color:$primary;"></kbd>. Versions appear on the canvas as each model finishes.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Reference images and the Loop option are not available in First to last frame mode.
{% endhint %}
{% endtab %}
{% endtabs %}

***

## Review and export

Each generation produces multiple versions at the same time. Results appear on the canvas as **Model A**, **Model B**, and so on. The model behind each label is not shown, so your choice stays focused on the output itself.

{% stepper %}
{% step %}

#### Browse your versions on the canvas

Hover over any video card to play it. All versions from one generation appear on the same row, connected to their source scene.
{% endstep %}

{% step %}

#### Open a video to view it

Select the eye icon on any video card to enter the detail view. The video plays on the left. Its settings (prompt, frames used, ratio, duration) are visible on the right.

From this view, you can switch between versions without going back to the canvas.
{% endstep %}

{% step %}

#### Vote

Select 👍 or 👎 on the version you are reviewing. You can vote from the canvas or from the detail view.

Voting is required before you can export. Your votes also help TheSEA understand which models perform best for different types of content, and directly shape what gets built next.
{% endstep %}

{% step %}

#### Export

Once you have voted, the <kbd><mark style="color:$primary;">**Export**<mark style="color:$primary;"></kbd> button becomes active. Select it to download the video as an MP4.
{% endstep %}
{% endstepper %}

***

## FAQ

<details>

<summary><strong>What does the "Early access" tag in the header mean?</strong></summary>

Video is still in pilot. Results may vary as the models and the product continue to improve. Your votes and feedback directly shape what comes next.

</details>

<details>

<summary><strong>How do I write a video prompt?</strong></summary>

Start with your idea and the image you want to animate. Share both with a text model, such as Gemini or Claude.

> \[Describe what you want to happen in plain language].
>
> The product is \[brief description — color, material, shape].\
> The mood should feel \[one word or reference].\
> The product should \[move / not move].\
> The camera should \[stay still / move — describe roughly how].
>
> Write me a video generation prompt under 2000 characters.

</details>

<details>

<summary><strong>How do I get access to Video Playground?</strong></summary>

Video is in early access and enabled at the organization level. Contact your account manager to request access for your organization.

</details>

<details>

<summary><strong>Why is the Export button disabled?</strong></summary>

You need to vote (👍 or 👎) on the version you want to export before the button becomes active. Select your vote, then export.

</details>

<details>

<summary><strong>One version shows "Generation blocked." What should I do?</strong></summary>

Some models reject specific inputs due to content policies. Select <kbd><mark style="color:$primary;">**Adjust**<mark style="color:$primary;"></kbd> on the blocked card. You will return to the creation view with all your original settings pre-filled. Adjust your prompt or input image and generate again.

</details>

<details>

<summary><strong>One version failed. Can I retry?</strong></summary>

Yes. Select the retry button on the failed card. If the same version keeps failing, try adjusting your input.

</details>

<details>

<summary><strong>Can I generate with only one model?</strong></summary>

Yes. Select the dropdown arrow next to the <kbd><mark style="color:$primary;">**Generate**<mark style="color:$primary;"></kbd> button to open the model panel. All models are selected by default. Uncheck any you want to exclude. Your selection is remembered for the rest of the session.

</details>

<details>

<summary><strong>Can I use reference images in First to last frame mode?</strong></summary>

No. Reference images are only available in Single image mode.

</details>

<details>

<summary><strong>What aspect ratios and durations are supported?</strong></summary>

Aspect ratio: Landscape (16:9) and Portrait (9:16).

Duration: 4 seconds (default), 6 seconds, and 8 seconds.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.theseaai.com/video/video-overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
