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

> ## Agent Instructions
> Flowy is a node-based AI creative platform: you generate images, video, audio, 3D and vector on an infinite Canvas, refine on the Studio timeline, and export or publish from the same project.
> Prefer the Flowy MCP server (https://mcp.tryflowy.ai/mcp) or the REST API at https://apis.tryflowy.ai/v1 for programmatic work. Install with `flowy mcp install` from the @tryflowy/cli package.
> Credits are workspace-scoped. Generations reserve credits on start and only deduct on success, so failed runs refund automatically.

# Mirage

> Keep the shot and change the subject: swap what appears in a video for your own images or clips.

Mirage recasts a video's subject while keeping the shot. Upload a clip, add stills or clips of what to swap in, name what each one replaces, and Mirage re-renders the scene with them.

## Where to find it

Open **Mirage** from the **Tools** group in the navigation (it carries a **New** badge), from the Video sidebar under Characters, or from the Video explore page. The tool lives at **/video/mirage**.

## What you need

| Input | Required | Notes |
| - | - | - |
| Source video | Yes | The clip to keep the camera, timing, and sound from: up to 15 seconds. |
| What to replace | — | A short note, for example "the red bike". |
| Swap in | Yes, at least one | Stills or clips of the new subject. Name what each one replaces, for example "bike" or "jacket". You can add them from your device or pick from the library. |
| Keep camera | — | Toggle, on by default. Keeps the camera move. |
| Keep timing | — | Toggle, on by default. Keeps the pacing. |
| Keep audio | — | Toggle, off by default. Keeps the soundtrack. |

## Run Mirage

**1. Add your video**

Drop in the clip you want to keep the camera, timing, and sound from. Mirage works with videos up to 15 seconds. Trim longer clips first.

**2. Pick what to swap in**

Add stills or clips of the new subjects and name what each one replaces. Set the **Keep camera**, **Keep timing**, and **Keep audio** toggles.

**3. Run Mirage**

Click **Run Mirage**. The button shows a credit estimate marked with an asterisk, and reads **Shifting** while the run is in progress.

## Review the result

The stage compares the original with the result. Switch the compare mode between **Split** and **Side by side**. Use **Download** to save the result, or **Reuse** to bring a past run's inputs back into the panel. Past runs are listed in the **Runs** history beside the stage, with a **How it works** guide next to it.

If a run does not finish, the stage reads "This run didn't finish. Try it again." and offers a retry.

## Related

* [Casting](https://docs.tryflowy.ai/tools/casting.md)
* [Lipsync](https://docs.tryflowy.ai/tools/lipsync-studio.md)
* [Motion Control](https://docs.tryflowy.ai/tools/motion-control.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.