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

# Music videos

> Cut a lip-synced music video to your song: upload, lip-sync modes, sections, writing, draft or final, sets and cast pictures

A Director music video is cut to your own song. Director listens to the track, finds the vocal, plans one 15-second section at a time, and lip-syncs your artist to the real song. Every cut lands on the music.

Open [Director](https://beta.pixio.myapps.ai/home/director) and choose **Music video** under **What are we making?**

## What you need before you start

The **Write the treatment** button stays disabled until three things are in place. The hint under it tells you what is missing.

| You need | Why |
| - | - |
| **Your idea** | At least 8 characters. Shorter pitches get *Tell Director a little more.* |
| **Your song** | The video is cut to it. |
| **A picture of your artist** | At least one cast picture marked **Person**. People only ever come from your pictures. |

## Upload the song

Drop the track on **What Director heard**, click **Choose a file**, or pick one with **From My Assets**.

* **Formats:** MP3, WAV or M4A (AAC, FLAC and OGG files are accepted by extension too).
* **Length:** up to **6:00**. A longer song is refused with *Songs can be up to 6:00. Trim it and try again.*
* **One song per video.** Use **Replace song** to swap it before you write the treatment.

Once the song is in, the panel shows the waveform, the running time and how many 15-second sections it makes. You can play it and scrub through it.

### How sections are counted

The song is cut into **15-second sections**, and each section is shot, priced and retaken on its own.

| Song length | Sections |
| - | - |
| 0:30 | 2 |
| 1:00 | 4 |
| 3:30 | 14 |
| 6:00 | 24 |

A leftover shorter than half a frame (for example the padding at the end of a 30.0-second file) joins the last section rather than becoming a section of its own. Any other leftover is a section.

The panel also shows a rough time estimate: about 5 minutes of studio time per section with **Performance** lip-sync, about 7 with **Sung words**. It is a planning hint, not a promise.

## Add your cast

Click **Cast** to open the **Call sheet**. You can add up to **9 pictures** in total, by dropping them in, with **Upload pictures**, or from **My Assets**.

* Give each picture a role: **Person**, **Prop** or **Place**. The first person you add is marked **LEAD**.
* At least one picture must be a **Person** — that is who sings to camera.
* With only one picture of your artist, the panel suggests adding a close-up for sharper lip-sync.

See [Cast & sets](https://support.myapps.ai/director/cast-and-sets.md) for what makes a good picture.

## Choose who writes it

Two cards sit at the top of the pitch:

> [card] Director writes it
>
> Every section written from your pitch, then you change anything you like. **151 credits**, charged when the treatment lands. Usually about 2 minutes.

> [card] I’ll write it
>
> You write each section and pick who is in it. No writing step: **free and instant**. Director's designed sets are not used.

With **Director writes it**, the button reads **Write the treatment**. You can leave the page while it writes — the treatment waits for you.

With **I’ll write it**, the box asks for a title and the idea, and the button reads **Set up the shots**. Director opens one empty section per 15 seconds of the song.

## Lip-sync modes

Open **Settings** (or the look chip) to reach **Director’s settings**. Music videos have a **Lip-sync** row:

| Mode | What it does |
| - | - |
| **Performance** (default) | Best faces and mouths. |
| **Sung words** | Shots follow your lyrics. |

Neither mode changes the price.

## The treatment

When the treatment is ready, every section sits on a timeline over the song. Click a section to:

* **Rewrite it** in **What happens in this section**. Changes save on their own; `Ctrl + Enter` moves to the next section.
* **Pick who is in it** under **Who and where**. **Everyone** lets any picture appear; picking pictures limits that section to them.
* **Screen test it** for **93 credits**: a 15-second test of that section with the song's own stretch as the soundtrack, so you see the lips on the real music before you commit.

### Notes and rewrites

With **Director writes it**, use the **Tell Director…** box (or a quick chip such as *More night scenes* or *Slower*) to send a note. Director rewrites the treatment with it.

* Each rewrite is charged the writing price again (**151 credits** for a music video).
* You get **4 rewrites**. After the last one: *That was the last rewrite — greenlight it, or start a new pitch.*

## Designed sets

With **Director writes it**, **Design the sets** in **Director’s settings** decides whether Director adds places and props of its own:

| Option | What happens |
| - | - |
| **Yes** (default) | Director designs up to 4 places and props, never people. **100 credits** (4 × 25), added to the greenlight. |
| **Only mine** | Only your pictures are used. |

You can also design any planned picture yourself before the shoot. See [Cast & sets](https://support.myapps.ai/director/cast-and-sets.md#designed-set-pictures).

## Draft or final

The **Greenlight** card offers two passes:

| Pass | What it is | Per section |
| - | - | - |
| **Draft first** | Fast, lower-res. Watch a quick draft of every section, then render the final from it — same song and shots, full quality. | 180 credits |
| **Final** | Full quality in one go. | 201 credits |

After a draft premieres, **Render the final from this draft** charges the final sections again at 201 credits each (and Look & sound again, if you added it). The writing and the designed sets are not charged twice. You can also choose **Keep the draft as final**.

> [!TIP]
>
> A draft only saves money if you would otherwise shoot the final more than once. For a 1-minute song, draft then final is 1,775 credits in total; straight to final is 1,055.

## Greenlight

Press **Greenlight & start shooting** (or **Greenlight the draft**). All sections shoot at once. You can leave the set — it keeps shooting without you. Open **What’s in the price** on the card to see every line.

Prices for typical songs, with **Director writes it** and **Design the sets: Yes**:

| Song | Straight to final | Draft first (draft only) |
| - | - | - |
| 1:00 (4 sections) | 1,055 | 971 |
| 3:30 (14 sections) | 3,065 | 2,771 |

With **I’ll write it**, a 1:00 song is 804 credits (sections only).

## After the premiere

Retake any single section, sharpen faces, upscale to 1080p and download. See [Premiere & fixes](https://support.myapps.ai/director/premiere-and-fixes.md).

## Related

* [Look & sound](https://support.myapps.ai/director/look-and-sound.md) — colour filters, vignette and a matched look. Your song stays the soundtrack, so music videos never get a score or laugh track.
* [Pricing & billing](https://support.myapps.ai/director/pricing-and-billing.md)
* [Troubleshooting](https://support.myapps.ai/director/troubleshooting.md)


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