> ## 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.

# Cast & sets

> Reference pictures, designed set and cast pictures, screen tests and describing your cast — with limits and prices

Your pictures are how Director keeps every face, prop and place the same in every shot. Add them on the **Call sheet** before you pitch, and add or design more while the treatment is open. The cast locks once the shoot starts.

## Reference pictures

Click **Cast** on the pitch to open the **Call sheet**. Drop pictures in, use **Upload pictures**, or pick from **My Assets**.

* **Up to 9 pictures** per production. Extra pictures are left out: *Up to 9 pictures — added the first N.*
* **Formats:** JPG, PNG or WebP.
* Use pictures you have the rights to.

| Role | Use it for | Tip |
| - | - | - |
| **Person** | Everyone who appears | One clear, well-lit photo of each face |
| **Prop** | Objects — and, in a commercial, the product | The chain, the car, the guitar |
| **Place** | A room or street to shoot in | |

The first person you add is the **LEAD**. Pictures after the first come in as props; change the role on each card.

> [!NOTE]
>
> **People only ever come from your pictures.** Director designs places and props, never people.

### Music videos vs films

* **Music videos** need at least one **Person** picture — that is who sings to camera.
* **Films** don't need any. Leave the Call sheet empty and Director casts its own. If you write the scenes yourself, you need at least one picture to greenlight.

## Describing your cast

Each card has a **name** (up to 60 characters) and a short line about the picture (up to 140 characters). The placeholders show the idea:

* Person: "The artist — gold chain, calm swagger"
* Prop: "A vintage chrome microphone"
* Place: "Underground garage, wet floor, neon"

Every picture needs a name; an unnamed one stops the pitch with *Give every picture a name.* If you leave the description empty, Director writes a one-line description of what the picture shows before it writes or shoots, so the studio is never told a file name.

> [!TIP]
>
> For a person, describe hair, build and clothing rather than the face. The picture carries the face.

## Adding pictures after the pitch

While the treatment is open, open **Cast & sets** (music videos) or **Cast & places** (films) and use **Upload or pick from My Assets** under **Add your own pictures**. You can remove any of your own pictures there too. Your own pictures are capped at 9.

In each section or scene, **Who and where** picks which pictures appear: **Everyone**, or only the ones you select.

## Designed set pictures

When Director writes the treatment, it can plan pictures of its own — places, props, and cast pictures built from your photos. They appear in the sheet under **Sets Director designs** (music videos) or **Cast & places Director designs** (films). On a film, the **Make the cast & places** row shows how many are still to design.

For each planned picture:

* **See prompt** shows the prompt it will be drawn from. Edit it and click away to save; it is used the next time the picture is designed. Prompts lock once the shoot starts.
* **Design now** draws it. **Redesign** draws it again.

| Picture | Price |
| - | - |
| A place or prop | 25 credits |
| A picture of someone in your cast, built from their photos | 42 credits |

A picture built from your cast uses at most two of your photos, so the face holds.

### Music videos: Design the sets

For music videos written by Director, **Design the sets** in **Director’s settings** decides whether Director designs up to 4 places and props at the shoot:

| Option | |
| - | - |
| **Yes** (default) | Up to 4 places and props, never people. 100 credits (4 × 25), part of the greenlight. |
| **Only mine** | Use only your pictures. |

If a shoot stops before any section is finished, the designed sets are not charged.

### How many pictures reach the shoot

At most **9 pictures** go to the studio. Yours always go first; designed pictures fill the remaining room.

## Screen tests

A screen test shoots **15 seconds** of one section or scene before you greenlight the whole thing: **93 credits**.

1. Select the section or scene on the timeline.
2. Press **Screen test this beat**. It shows **Shooting a 15 s test of this beat…** while it runs.
3. Watch it on the monitor. Press **Shoot another test** for a new one.

* **Music videos:** the test uses that stretch of your song as the soundtrack, so the lips sync to the real song. The song needs to be MP3, M4A or WAV for this.
* **Films:** your voice clips go along (the first 15 seconds of each), so any line is spoken in the voice the full film will use.
* A section must have text before you can test it.
* A test that does not come back is not charged.

## Limits

| Item | Limit |
| - | - |
| Pictures per production | 9 |
| Voice clips per film | 3 |
| Picture name | 60 characters |
| Picture description (on the Call sheet) | 140 characters |
| Side jobs at once (screen tests, designed pictures, retakes, upscales, face fixes) | 4 per production |

## Related

* [Music videos](https://support.myapps.ai/director/music-videos.md)
* [Short films](https://support.myapps.ai/director/films.md#voices-and-voice-lock) — voice clips and voice lock
* [Commercials](https://support.myapps.ai/director/commercials.md#your-product) — prop pictures as the product


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