> For the complete documentation index, see [llms.txt](https://docs.acestudio.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.acestudio.ai/ai-tools/music-video.md).

# Music Video

## What Is Music Video

Music Video turns a song into a finished, fully edited music video. You work with an AI agent — the **Director** — that handles scriptwriting, casting, scene design, choreography, storyboarding, video generation, and editing. You stay in charge of the creative decisions.

There are two ways to produce:

* **Highly Customized** — a full-length music video for the whole song, with step-by-step detailed production. 25k+ credits.
* **Promo Clip** — a short clip made from one section of your song, built for Instagram Reels, TikTok, YouTube Shorts, and other social posts. 500+ credits.

{% embed url="<https://www.youtube.com/watch?v=amx7gYLPW10>" %}

## Your Director

The Director is a single agent that runs the whole production end to end, and you're the only person it answers to. Each phase of production is driven by a dedicated **skill** — a professional playbook the Director picks up when that phase begins, the way a film director switches between department briefs. You'll sometimes see the Director reading or using a skill in the chat; that's all there is to it — skills work on their own, and you never need to manage them.

What that looks like across a production:

| Phase                 | What the Director does                                                        | What you see                                   |
| --------------------- | ----------------------------------------------------------------------------- | ---------------------------------------------- |
| **Creative planning** | Writes the creative plan and the script for every shot                        | Creative plan, shot scripts                    |
| **Casting**           | Designs your character's base look and per-scene looks                        | Character sheets (multi-view), per-scene looks |
| **Art & storyboards** | Defines the visual style, designs scene environments, draws storyboards       | Style guide, scene references, storyboards     |
| **Choreography**      | Designs dance and performance moves, creates motion keyframe grids            | Choreography docs, motion keyframes            |
| **Cinematography**    | Writes generation prompts, runs video generation, handles lip-sync refinement | The final video shots                          |

## How It Works

1. Start from your ACE Studio project — a song you produced, or a finished track you imported. Click <kbd>Music Video</kbd> in the top-right corner and start the session; the Director renders your project as the song and analyzes it.
2. Set up the video in three quick steps: choose **Highly Customized** or **Promo Clip**, pick an aspect ratio (16:9, 9:16, 3:4, or 1:1), then describe your idea — you can also upload your own character image.
3. The Director asks the remaining onboarding questions, then works through the pipeline — casting, scene design, creative plan, shot scripts, looks, optional choreography, and storyboards. You review and give feedback at each milestone.
4. The storyboards are placed on the [Canvas](/project/arrangement-in-canvas/canvas.md) as an animatic, so you can preview the full video's pacing before anything is rendered.
5. When everything is ready, you give the go-ahead. Shots render in parallel, replace the storyboards automatically, and singing shots get a lip-sync refinement pass.
6. Watch the result, then request changes — only the affected shots are regenerated.

For the full walkthrough, see [Creating a Music Video](/ai-tools/music-video/creating-a-music-video.md). For the short-form flow, see [Creating a Promo Clip](/ai-tools/music-video/creating-a-promo-clip.md). For revisions, manual edits, and resuming a project, see [Editing & Iteration](/ai-tools/music-video/editing-and-iteration.md).

## Choosing a Video Model

Your video model choice affects more than image quality — different models allow different **maximum shot lengths**, which changes how the Director scripts your shots. If you already know what style you're going for, pick the model early; if not, the default works great for most cases.

| Model                    | Best for                             | Max shot length                                      |
| ------------------------ | ------------------------------------ | ---------------------------------------------------- |
| **MiniMax-H3** (default) | Animation, anime, illustrated styles | 15s                                                  |
| **Seedance 2.0**         | Realistic, live-action styles        | 15s                                                  |
| **Seedance 2.5**         | Extra-long continuous shots          | Over 15s — at double the credit cost of Seedance 2.0 |

You can switch models in the selector below the chat input, or simply tell the Director which model to generate with.

## Credit Pricing

Music Video uses Credits for music analysis, image generation, video generation, and Agent LLM usage.

<table data-search="false"><thead><tr><th width="144.2421875">Category</th><th width="148.69921875">Model or feature</th><th width="246.6171875">Billing unit</th><th width="180.98046875">Credit cost</th></tr></thead><tbody><tr><td>Music analysis</td><td>Music Analysis</td><td>Per request</td><td>≈20 per minute</td></tr><tr><td>Image models</td><td>Midjourney</td><td>Per request</td><td>20</td></tr><tr><td>Image models</td><td>Nanobanana</td><td>Per request</td><td>25</td></tr><tr><td>Image models</td><td>GPT Image 2</td><td>Per request</td><td>15</td></tr><tr><td>Image models</td><td>Qwen Image Multiple Angles</td><td>Per request</td><td>7</td></tr><tr><td>Video models</td><td>MiniMax-H3</td><td>Per second</td><td>22</td></tr><tr><td>Video models</td><td>Seedance 2.0 (1080p)</td><td>Per second</td><td>68</td></tr><tr><td>Video models</td><td>Seedance 2.0 (720p)</td><td>Per second</td><td>34</td></tr><tr><td>Video models</td><td>Seedance 2.5 (1080p)</td><td>Per second</td><td>136</td></tr><tr><td>Video models</td><td>Seedance 2.5 (720p)</td><td>Per second</td><td>68</td></tr><tr><td>Video models</td><td>Lipsync 3</td><td>Per second</td><td>25</td></tr><tr><td>Agent</td><td>Agent LLM Tokens</td><td>Based on actual token usage</td><td>Varies by task</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.acestudio.ai/ai-tools/music-video.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.