ミュージックビデオには、撮影も編集も予算も必要でした。今は AI で MV を作成するのに、API 呼び出し 1 回で済みます。POST /v1/videos/music に曲と短いブリーフ（ストーリー、ルック、歌い手）を送ると、曲と同じ長さの mp4 が 1 本返ってきます。シーンはビートで切られ、どのシーンにも同じ歌い手が登場して歌詞に合わせて口を動かし、音源は元の曲をそのまま使います。音楽アプリ、レーベルのリリース作業、クリエイター向けツールに組み込むことも、コードを書かずに Playground で作ることもできます。
AI エージェントに任せる
このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。
Make a music video from a song with the Lovely Router music video API: it cuts the song on the beat into scenes, casts one singer, renders every scene with the song driving the picture and joins them into one mp4 over the original track. - Docs (read first): https://lovelyrouter.com/docs/models/music-videos.md and https://lovelyrouter.com/docs/api/music-videos.md - Start: POST https://lovelyrouter.com/v1/videos/music (multipart) with `song` (MP3/WAV/FLAC/OGG/M4A, up to 60 MB), `model` (`ltx-music-video`, or `minimax-h3-music-video` for the steadiest likeness), `size` (`16:9`, `9:16` or `1:1`), an optional brief (`story`, `style`, `character`, `locations`, `lyrics`) and `consent=true` (accepts the model's terms; read the licence linked in the docs first and tell me if my use might not be allowed). - It answers 202 at once. Poll GET https://lovelyrouter.com/v1/videos/music/<id>?wait=120 until `status` is `completed`, `failed` or `cancelled`, then download GET https://lovelyrouter.com/v1/videos/music/<id>/content (kept 7 days). - Billed per second of the song (at least 15 s), plus the director's chat calls and the character pictures. Once started it can't be stopped: send `auto_render: false` to stop at `ready`, show me the character sheets and scene prompts, and only call POST .../render after I approve. Use `start`/`end` (seconds) to make it for part of the song. - For a recurring artist, save them once with POST https://lovelyrouter.com/v1/characters (docs: https://lovelyrouter.com/docs/api/characters.md) and pass `character_id`. - Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys. - Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large. - Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt. My task: <the song file, what the video should show (story, style, singer) and the aspect ratio>
仕組み
曲とブリーフを送る
MP3、WAV、FLAC、OGG、M4A のファイル（最大 60 MB）をアップロードし、必要なら
story、style、character、lyricsを添えます。どの項目も省略できます。ブリーフがなければ、ディレクターが歌詞からストーリーと歌い手を考えます。ビートで切って、配役は一度だけ
曲はビートで終わるシーン（1 つ約 5 秒）に分けられ、歌詞はシーンごとに書き起こされます。ディレクター役のチャットモデルが歌い手を一度だけ定義し、画像モデルが衣装ごとにターンアラウンドシート（正面・横・背面）を描くので、どのシーンも同じ人物になります。
シーンごとに演出してレンダリング
ディレクターがブリーフとそのシーンの歌詞から、カメラワークと照明を含むショットを 1 シーンずつ書きます。各シーンは対応する曲の部分が映像を動かします。口の動きは歌詞に、動きは音楽に合います。
元の曲に乗った 1 本の mp4
シーンは元の曲の上に順番につながれます。各クリップはレンダリングが終わった時点で見られ、完成した動画は 7 日間ダウンロードできます。
1 回のリクエストで作る
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リクエストはすぐに 202 とミュージックビデオオブジェクトを返します。GET /v1/videos/music/{id}?wait=120 をポーリングして status、progress、各シーンを確認し、completed になったら GET /v1/videos/music/{id}/content でダウンロードします。Python と Node.js の同じ流れはミュージックビデオのガイドにあります。
使うツール
POST /v1/videos/music がビート解析、配役、キャラクターシート、演出、レンダリング、最終編集まで一通り実行します。画角は 16:9、9:16、1:1 から選べます。リファレンス：ミュージックビデオ API。
POST /v1/characters でアーティストを一度保存し（名前、説明、ターンアラウンドシート）、毎回 character_id を渡せば、アルバム全体で同じ顔になります。保存は無料です。キャラクターを参照してください。
start と end を秒で送ると、サビや最初の 1 分だけの動画を作れます。料金は曲全体ではなく切り出した長さの分です。Playground にはプレビュー付きのスライサーがあります。
auto_render: false にすると、全シーンのプロンプトと最初のフレームがそろった時点で止まります。PATCH で好きなシーンを書き直してから POST …/render します。破棄したプランには動画の料金がかかりません。
あなたのキーで画像生成 API が描きます。歌い手の写真（character_image）からでも、ブリーフからでも作れます。画像モデルは image_model で選びます。
director_model には、キーで使える任意のチャットモデルを指定できます。速くて安いモデルで十分です。
2 つのモデル
| モデル | 曲 1 秒あたりの料金 | 向いている用途 |
|---|---|---|
ltx-music-video | $0.06 | レンダリングが速く、1 シーン約 20〜25 秒。3 分の曲ならおよそ 12〜15 分。最大 1472×832。 |
minimax-h3-music-video | $0.13（first_frames 使用時 $0.2） | キャラクターシートから直接歌い手を撮るので見た目が最も安定。1 シーン約 45 秒。最大 1344×768。 |
どちらも 5 秒から 6 分の曲に対応し、最低 15 秒分が課金され、24 fps でレンダリングします。各リクエストでは consent: true を指定してモデルの規約に同意します。LTX の規約と MiniMax H3 の規約で、後者は EU、英国、韓国、米国での利用を認めていません。
レシピ
POST /v1/characters でアーティストを保存し、シングルごとに character_id と 1 行のストーリーで API を呼びます。どの動画も同じ顔が主役です。
size=9:16 を指定し、start と end でサビの聞かせどころを切り出せば、Reels、Shorts、TikTok 向けの 15〜60 秒の縦型動画になります。
auto_render: false にして、キャラクターシートと最初のフレームをユーザーに見せ、シーンを書き直してもらってからレンダリングを始めます。
レンダリング中は各シーンのクリップ（scenes[n].url）を順に表示できます。
歌詞を書いたとおりに lyrics で、言語を language（en、zh、ja など）で渡すと、ディレクターは各歌唱ショットで正しい歌詞を引用します。
権利と責任ある利用
自分が権利を持つ、または許諾を得た曲と、描写の許可を得た人物を使ってください。動画はモデルの規約と利用規定に従う必要があります。完成した動画は 7 日間保存された後に削除されるので、残したいものはダウンロードしてください。
よくある質問
音楽は自分で用意する必要がありますか？+
はい。曲から MV を自動生成する仕組みなので、動画はあなたの曲を中心に作られます。ビートがカットを決め、歌詞が歌唱を動かし、完成した mp4 の音源もその曲です。最長 6 分の曲をそのまま送るか、長い曲の一部を切り出して送ってください。
歌い手はどのシーンでも同じに見えますか？+
はい、デフォルトではそうなります。歌い手は一度だけ配役され、衣装ごとにターンアラウンドシートが描かれ、すべてのシーンがそのシートから始まります。顔を自分で決めたいときは、写真を character_image で、または保存したキャラクターの character_id を送ってください。
1 本作るのにどれくらいかかりますか？+
解析は 1 分未満、キャラクターシートは数分です。その後シーンが順にレンダリングされ、3 分の曲なら ltx-music-video で約 12〜15 分、minimax-h3-music-video で約 25〜30 分です。温まった GPU がないときは約 1 分半増えます。
レンダリング前にシーンを編集できますか？+
できます。auto_render: false を送ると、各シーンのプロンプトと最初のフレームがそろった ready で止まります。PATCH でシーンを書き直し、POST /v1/videos/music/{id}/render でレンダリングを始めます。破棄したプランは無料です。
どの画角で作れますか？+
YouTube 向けの 16:9、縦型ショート動画向けの 9:16、フィード向けの 1:1 です。すべて毎秒 24 フレームでレンダリングします。
AI エージェントに MV を作らせられますか？+
はい。このページのプロンプトを Claude Code、Cursor、Codex にコピーしてください。エージェントに Markdown のドキュメントの場所を伝え、エージェントがあなたのキーで API を呼び出します。
静止画は画像生成 API、すべてのエンドポイントと項目はミュージックビデオ API リファレンスを参照してください。