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

> ## Agent Instructions
> Marsell's MCP server is at https://getmarsell.com/mcp: agents connect with a key the owner makes in the app (a project's Agents page, Your own AI). See /developers/mcp for its tools. There is no public REST API yet; don't suggest REST endpoints.
> The search MCP server at https://docs.getmarsell.com/mcp only searches these docs. It can't read or change anyone's Marsell projects.
> Each business is a project with seven places: Home, Create, Market, Sell, People, Agents and Brand. 'Marsell plan' means the subscription (Solo, Core, Growth, Network); 'the plan' or 'the week' means the work Marsell has planned.
> Tokens are Marsell's unit for AI and media work, granted monthly by the Marsell plan. They are not model tokens.

# Films

> How Marsell makes a film: pick the kind, read the script first, step through the voices and the plan, direct the shots and lines, decide on the check's notes, and finish in HD or 2K.

Marsell makes films three ways: **AI-filmed**, with real motion from video models; **Animated**, motion graphics drawn in code; and **Edited stills**, your pictures cut together. Every film you ask for starts as a script you read first, and nothing costly is made before your yes. Each step shows its price and the share of your month it uses.

## Make a film

<Steps>
  <Step title="Choose A film">
    In the make bar in Create, choose **A film**.
  </Step>

  <Step title="Pick the kind">
    **AI-filmed** ("Real motion, filmed by the video models"), **Animated** ("Motion graphics drawn in code") or **Edited stills** ("Pictures cut together"). Each shows about what the whole film takes.
  </Step>

  <Step title="Say what it's about">
    A line or two on what happens in it.
  </Step>

  <Step title="Write the film">
    Press **Write the film**. The button shows the script's price; the line above it says what the whole film takes. The script is written, and waits on the film's board for your yes.
  </Step>
</Steps>

A film starts only if your plan has the whole film's budget left this month, not just the script's. Films are made at 768p in 9:16 for Instagram, and you can finish them larger later. **Open the film's board** takes you to it; you can also ask Marsell in the chat to make a film, and it opens the board for you.

## The film's board

The board shows the film's kind, quality and steps: **Research** (when the kind does it), **Script**, **Your yes**, **Read-through**, the pictures or clips, **Edit**, **Render**, **Check** and **Titles**. While a step runs, it shows the time on the step and the tokens used against the film's budget.

### Read the script

"Read the script before anything costly is made." The script is shown scene by scene.

* **Looks good, go on**, with its price and the share of your month, makes the next part.
* **Hear the read-through** plays it.
* **Ask for changes**, then **Send it back to the writer**, rewrites it from what you say.

### Step through with me

Films you make on your show can stop at each costly step, with **Continue** and its price:

* **A new character needs a voice**: pick it by ear. Picking a voice costs nothing.
* **The table read**: listen before the pictures are made.
* **The plan and its first frames**: look at them before any clip is paid for.

Turn off **Step through with me** and the film runs to the end; you watch it and decide.

### Direct it

**The board** lists every scene, shot and line. Nothing you mark is spent until you go on.

* **Shots:** **Change words**, **Try again** (a new seed, a new first frame or a new picture, each priced), **Lock** a shot so it's never made again, and pick which model films it.
* **Lines:** **Direct it** with tags such as \[calm], \[deadpan], \[whispers] or \[laughs], set pauses and who says it, and choose among **Takes**: keep one, **Take it again** or **Say it another way**.
* **Make these changes**, with the price, makes what you marked.

## When Marsell's check finds something

Before a film is done, the Checker watches it for mistakes: the sound, the picture, the characters and look, the format. A film with nothing to note is ready on its own. Otherwise it waits: "Watch it, then decide." with the notes under **What Marsell's check noticed**:

* **Fix these** makes it again from the step the check named, at the price shown;
* **Use it as it is** finishes it as it stands.

The check's notes are advice, not a verdict: nothing is made again unless you press **Fix these**.

## Finish it

* **Finish in HD** or **Finish in 2K** renders the film again at that size, with every take kept, at the price shown.
* **Ask for changes**, then **Make it again with these changes**, makes a new film and keeps this one.
* **Stop making this video** stops one that's running; **Drop this video** lets go of one that waits.

To keep a finished film, play it on its board or in **Made for you** and save the file from the player.

## Films the plan makes

When the week's plan calls for a film, Marsell makes it in code and brings it to **What needs you**: **Approve the film**, **Ask for changes** or **Skip**. The card shows the film, its length and cost, and says that nothing is posted.

## When a film runs out of tokens

Every film has a budget: the estimate and a fifth. It stops to ask before going past it. If it runs out partway, the board says **Out of tokens for this video**, with what it needs and what it's short by, and **Allow** that much more **and carry on**. It continues from where it stopped, if your plan has those tokens left this month. If it doesn't, the board offers **Add tokens** in place of the button, and nothing is spent.

## What films cost

| Film | About |
| - | - |
| The script | 2,500 tokens |
| A Short made in code | 10,000 tokens |
| A part-filmed Short | 40,000 tokens |
| A fully filmed Short | 60,000 to 80,000 tokens |

Every film shows its own estimate before you start, and every paid step on the board shows its price. If a price changes before you press, Marsell asks you to look again. See [Marsell plans and tokens](/account/plans-and-tokens).

<CardGroup cols={2}>
  <Card title="Shows" icon="tv" href="/create/shows">
    A channel of your own, with its own characters.
  </Card>

  <Card title="Chat with Marsell" icon="message-circle" href="/chat">
    Ask for a film, or change one, in words.
  </Card>
</CardGroup>


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