AI music video generator API:
a song in, a music video out

1. Send the song and a brief

   Upload an MP3, WAV, FLAC, OGG or M4A file (up to 60 MB) and, if you like, a story, a style, a character and lyrics. Every field is optional: with no brief, the director invents a story and a singer from the lyrics.

2. Cut on the beat, cast once

   The song is split into scenes that end on its beats, about 5 seconds each, and the lyrics are transcribed scene by scene. A chat model, the director, defines the singer once and an image model draws a turnaround sheet (front, side, back) for each outfit, so every scene shows the same person.

3. Directed and rendered scene by scene

   The director writes a shot for each scene from your brief and its lyrics, with the camera move and the light. Each scene is rendered with its part of the song driving the picture: the singer's lips follow the words, and movement follows the music.

4. One mp4 over your track

   The scenes are joined in order over the original song. You can watch each clip as soon as it renders, and download the finished video for 7 days.

curl https://lovelyrouter.com/v1/videos/music \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -F model=ltx-music-video \
  -F song=@song.mp3 \
  -F story="A night drive through a neon city; she leaves the old town behind and reaches the sea at dawn" \
  -F style="Cinematic 35 mm film, teal and orange, light rain, shallow depth of field" \
  -F character="A woman in her twenties with short black hair, a red leather jacket and silver hoop earrings" \
  -F size=16:9 \
  -F consent=true

The request answers 202 at once with the music video object. Poll GET /v1/videos/music/{id}?wait=120 for its status, progress and scenes, then download GET /v1/videos/music/{id}/content when it is completed. The music videos guide has the same flow in Python and Node.js.

Both take songs from 5 seconds to 6 minutes, bill at least 15 seconds, and render at 24 fps. Every request sets consent: true to accept the model's terms: the LTX terms or the MiniMax H3 terms, which don't allow use in the EU, the UK, South Korea or the US.

You pay per second of the song: $0.06 with ltx-music-video, so a 3½-minute song costs $12.6; $0.13 with minimax-h3-music-video. The director's calls and the character pictures (typically one per look plus one per scene) are billed separately at those models' own prices. When the song's length is known, its price is held from your prepaid balance, and the video settles as one charge in your logs. If a video fails on our side, nothing is charged for it. Prices for every model are on pricing.

Use songs you own or have the rights to, and people you have permission to depict. Videos must follow the model's terms and the Acceptable Use Policy. Finished videos are kept for 7 days, then deleted; download what you want to keep.