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

# Director API

> Make music videos, films, TV episodes, commercials and shots with Montage from your own code

The **Director API** gives your scripts and agents everything [Director](https://support.myapps.ai/create/director.md) does in the app, powered by [Montage](https://support.myapps.ai/montage.md). It uses the same API keys, the same credits and the same prices as the app.

> [!NOTE]
>
> The full, always-current guide — every endpoint, field, limit and price — is served by the API itself at **[/api/v1/guide](https://beta.pixio.myapps.ai/api/v1/guide)**, and the endpoints appear in the [live API reference](https://beta.pixio.myapps.ai/api-docs). This page is the overview.

## Authentication

Every request needs an [API key](https://support.myapps.ai/integrations/api-keys.md):

```bash theme={null}
Authorization: Bearer <PIXIO_API_KEY>
```

## How a job works

**1. Start it**

`POST` to an endpoint below. The response has a job `id`, the credits held for it, and an estimated time.

**2. Follow it**

Poll `GET /api/v1/director/jobs/{id}`. The status moves from `queued` to `running` to `done` (or `failed` / `cancelled`), with a plain-words stage and progress.

**3. Collect it**

When the status is `done`, the job has download links for the finished piece and each section.

## Endpoints

All paths are under `/api/v1`.

| What | Endpoint |
| - | - |
| Music video | `POST /director/videos/music` |
| Short film, commercial, explainer, documentary | `POST /director/videos/film` |
| TV series & episodes | `/director/series`, `POST /director/series/{id}/episodes` |
| Retake one section | `POST /director/videos/{music\|film}/{id}/redo` |
| Final from a draft | `POST /director/videos/{music\|film}/{id}/final` |
| Packaging (title card, filter, score, captions…) | `POST /director/videos/package` |
| Single shot | `POST /director/videos/{text\|image\|reference}` |
| Upscale, finish, face fix | `POST /director/videos/{upscale\|finish\|facefix}` |
| Images | `POST /director/images/{text\|edit\|reference}` |
| Songs | `POST /director/music/generate` |
| Write clip prompts | `POST /director/prompts/write` |
| Prompt check (free) | `POST /director/prompts/check` |
| Looks & filters | `/director/looks`, `GET /director/filters` |
| Saved brands | `/director/brands` |
| Narration voices | `GET /director/voiceover/voices` |
| Storyboard (films from an idea) | `/director/jobs/{id}/storyboard`, `…/redo`, `…/approve` |
| Jobs | `GET /director/jobs/{id}`, `GET /director/jobs` |
| Catalog of voices, formats and options | `GET /director/catalog` |

## Billing

* The quoted credits are **held** when a job starts and **charged only for what is delivered**.
* A job the studio refuses, or one that fails before anything is made, releases its hold — nothing is charged.
* Stop a job and the sections still developing are free.
* Storyboard stills are charged by the number made; each redraw is charged as it's made.

See the price list on the [Montage](https://support.myapps.ai/montage.md#pricing) page.

## Limits

* 8 jobs in progress at once per account
* Text fields such as `idea` are limited to 4,000 characters, **counted as sent** — line breaks count as two characters
* Up to 9 reference pictures, 3 reference clips and 3 reference audio files per request


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