> ## Documentation Index
> Fetch the complete documentation index at: https://hyperframes-codex-docs-human-first-refactor.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a music-driven video

> Cut footage, images, lyrics, and motion to a track’s beat grid.

Use Music to Video when the supplied track should control the pacing.

The audio can come from a music file or from a video whose audio should drive the result.

<Frame caption="A track analysed for beats and sections, with every cut snapped to that grid.">
  <video className="aspect-video w-full object-cover bg-zinc-100 dark:bg-zinc-900" src="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/wfv2-music.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/wfv2-music.jpg" autoPlay muted loop playsInline />
</Frame>

## Give the agent the track and material

```text theme={null}
/hyperframes Make a 30-second beat-synced promo from track.wav and the
12 attached product photos. Start restrained, accelerate after the first
drop, and hold the final logo for two beats. No narration.
```

Tell the agent:

* which part of the track to use;
* whether lyrics appear;
* which media must be included;
* the desired format and duration;
* where the energy should change;
* whether the video must loop.

## Approve the musical structure

Confirm:

* the exact section of the track;
* the important beats, drops, phrases, or energy changes;
* which media and lyrics are approved;
* the visual arc from opening to ending;
* whether the edit should loop;
* how long text must remain readable even when the rhythm is fast.

## Review the rhythm

Not every beat needs a cut. Use stronger changes for important musical moments and leave enough visual continuity to understand the material.

Check:

* the first useful downbeat;
* cuts around drops and transitions;
* lyric timing;
* whether important text can be read;
* the ending or loop point.

Beat markers in the [Studio timeline](/studio/timeline) help refine the cut.

## Common problems

| Problem                                     | Better direction                                                 |
| ------------------------------------------- | ---------------------------------------------------------------- |
| Every beat causes a cut                     | Reserve larger changes for stronger musical moments.             |
| The edit is rhythmic but hard to understand | Hold important images and text across several beats.             |
| Lyrics drift from the vocal                 | Correct transcription and timing before visual polish.           |
| The ending feels cut off                    | Choose a musical landing or design a deliberate loop.            |
| Supplied media has no visual progression    | Assign different material to the intro, build, peak, and ending. |

<CardGroup cols={2}>
  <Card title="Refine timing in Studio" icon="timeline" href="/studio/timeline">
    Use beat markers to adjust cuts, holds, and the ending.
  </Card>

  <Card title="Choose another workflow" icon="route" href="/workflows">
    Return to the source-and-outcome chooser.
  </Card>
</CardGroup>
