> 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 production team — a Director plus four specialists — that handles scriptwriting, casting, scene design, choreography, storyboarding, video generation, and editing. You stay in charge of the creative decisions.

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

## Your Production Team

You only ever talk to the Director. The Director coordinates the other four roles behind the scenes — you never need to brief them separately.

| Role                             | What they do                                                                                                | What you see                                   |
| -------------------------------- | ----------------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
| **Director**                     | Runs the whole production, writes the creative plan and shot scripts, places the finished cut on the Canvas | Creative plan, shot scripts, the final cut     |
| **Casting Director**             | Designs your character's base look and per-scene looks                                                      | Character sheets (multi-view), per-scene looks |
| **Art Director**                 | Defines the visual style, designs scene environments, draws storyboards                                     | Style guide, scene references, storyboards     |
| **Choreographer**                | Designs dance and performance moves, creates motion keyframe grids                                          | Choreography docs, motion keyframes            |
| **Director of Photography (DP)** | 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. The agent renders it as your song, analyzes it, and asks you four questions: visual style, storytelling approach, lead character, and aspect ratio.
2. The team works through the pipeline — creative plan, casting, scene design, shot scripts, looks, optional choreography, and storyboards. You review and give feedback at each milestone.
3. 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.
4. 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.
5. 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 revisions, manual edits, and resuming a project, see [Editing & Iteration](/ai-tools/music-video/editing-and-iteration.md).

## 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>Seedance 2 (1080p)</td><td>Per second</td><td>68</td></tr><tr><td>Video models</td><td>Seedance 2 (720p)</td><td>Per second</td><td>34</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.