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

# Troubleshooting

> Common Director messages and refusals, what they mean and how to fix them — and what “Nothing was charged” means

Most Director messages tell you what to do next. This page collects the common ones.

## What “Nothing was charged” means

Director holds credits before it starts something and only charges them when the work is delivered. When a message ends with **Nothing was charged**, the hold for that step has already been released — there is nothing to refund and nothing to chase. You can try again straight away.

That covers a treatment that did not finish, a shoot or fix the studio would not start, a take that did not come back, a storyboard redraw that was refused, and running out of credits. See [Pricing & billing](https://support.myapps.ai/director/pricing-and-billing.md#holds-vs-charges).

A stopped or failed **shoot** is different: finished sections are charged and everything unfinished is free. The production page shows **What was charged**.

## Before you start

> [accordion] The Write the treatment button is disabled
>
> The hint under it names what is missing: *Add your idea, your song and a picture of your artist to start.* A pitch needs at least 8 characters; a music video also needs a song and a **Person** picture.

> [accordion] Add at least one picture of who is in the video.
>
> Music videos need at least one cast picture marked **Person** — that is who sings to camera. Open **Cast**, add a picture and set its role to **Person**.

> [accordion] Add the song first — the video is cut to it.
>
> Upload the song (MP3, WAV or M4A) before writing a music video.

> [accordion] Songs can be up to 6:00. Trim it and try again.
>
> Music videos are limited to 6 minutes. Trim the track and upload it again.

> [accordion] That isn’t an audio file. Try an MP3, WAV or M4A.
>
> The song (or a voice clip) wasn't recognised as audio. Export it as MP3, WAV or M4A.

> [accordion] Add pictures — JPG, PNG or WebP.
>
> Cast pictures must be images. Up to 9 per production; extras are left out.

> [accordion] Give every picture a name. / Give every voice clip a name.
>
> Every cast picture and voice clip needs a name. Fill in the empty name on the Call sheet.

> [accordion] Hold on — your files are still uploading.
>
> Wait for the uploads on the Call sheet to finish, then press the button again.

> [accordion] This needs N credits. Top up and try again — nothing was charged.
>
> You don't have enough credits for this step. Nothing was held. Top up, then try again.

## Text too long

The studio accepts at most **4,000 characters** for a pitch or an episode idea, **counted as the text is sent**. When text is sent, every line break travels as **two characters**. A pitch of 3,980 characters with 40 line breaks is 4,020 as sent — over the limit.

* **Pitches:** once you pass 80% of the limit, a counter appears under the pitch (for example **3,412/4,000**). Over the limit it adds **· the end will be trimmed**: Director keeps the start and cuts the end at a word. Notes you send for a rewrite are always kept whole, and the pitch gives way to make room for them. A commercial's brief is kept whole the same way.
* **TV episode ideas:** an idea over the limit as sent is refused with a message naming the field and the length (*… characters; the most is 4,000.*) and nothing is charged.

**Fix:** shorten the text or remove blank lines. Joining paragraphs saves two characters per line break.

## Writing the treatment

> [accordion] Director could not finish the treatment. Nothing was charged — try again.
>
> The writing hold was released. Try again from the same production.

> [accordion] Director lost the thread on that draft. Nothing was charged — try again.
>
> A write took far longer than it should and was given up. Director first tries to pick a stalled write back up on its own (**Picking the draft back up**); this message means that didn't work either. If you had a treatment before the rewrite, it is still there.

> [accordion] That was the last rewrite — greenlight it, or start a new pitch.
>
> Each treatment allows 4 rewrites. Edit sections by hand instead — editing is free — or start a new pitch.

## Greenlight

> [accordion] Write N more scenes to greenlight / Write every section first — N still empty.
>
> With **I’ll write it**, every section or scene needs text before the shoot.

> [accordion] Add a picture to greenlight / Add at least one picture — your scenes are shot from them.
>
> When you write a film yourself, it is shot from your pictures. Add at least one with **Add pictures** in **Who and where**.

> [accordion] The studio's prompt check refused it (scene N): …  Nothing was charged.
>
> Before a shoot starts, the studio checks the shots. If one breaks its rules, the shoot is refused with the reason and, where it can, the scene. Rewrite that scene in the treatment (or send a note) and greenlight again. Treatment checks marked **Fix before shooting** point at the same kind of problem before you press the button.

> [accordion] The studio refused it: field: message  Nothing was charged.
>
> A value was refused, for example text that is too long. Shorten or change the field it names and try again.

> [accordion] The studio could not start the shoot. Nothing was charged — try again.
>
> The shoot didn't start, and the hold was released. Try again in a moment.

> [accordion] N of M versions are shooting; the rest could not start: …
>
> When greenlighting versions, the ones that started keep shooting; the rest were removed. The reason follows — usually not enough credits.

## During and after the shoot

> [accordion] Four takes are already rolling. Let one land first.
>
> Up to 4 side jobs — screen tests, designed pictures, retakes, face fixes and upscales — can run at once on one production. Wait for one to land.

> [accordion] At most 8 Director jobs can run at once.
>
> TV episodes, and fixes on them, count toward a limit of 8 running at once per account. Wait for one to finish, then try again.

> [accordion] That take did not come back. Nothing was charged.
>
> A retake, face fix, upscale, screen test or designed picture failed. Its hold was released. Try again.

> [accordion] The shoot stopped before the end. Only the finished sections were charged — you can try again.
>
> Press **Shoot it again** to go back to the same treatment, re-quoted and charged only when you greenlight.

> [accordion] We could not cut this song for a screen test. Upload it as MP3, M4A or WAV.
>
> Music-video screen tests cut your song. Re-upload it as MP3, M4A or WAV.

> [accordion] The cast locks once the shoot starts. / Beats lock once the shoot starts. / Settings lock once the shoot starts.
>
> Pictures, sections and settings can only change while the treatment is open. To change them after a stop, use **Shoot it again**.

> [accordion] Stop the shoot before deleting it.
>
> Press **STOP · UNSHOT IS FREE** first, then **Delete this production**.

> [accordion] At most 50 series per account. Delete one first.
>
> Delete a series you no longer need. Its episodes stay in your Director.

> [accordion] Up to 2 styles at once — turn one off first
>
> **Advanced styles** layers at most two styles. Turn one off before adding another.

## Still stuck?

* [Premiere & fixes](https://support.myapps.ai/director/premiere-and-fixes.md) — retakes, face fixes and stopping
* [Pricing & billing](https://support.myapps.ai/director/pricing-and-billing.md) — holds, charges and the price list


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