Agent skill · creative production · samuraigpt
muapi-music-video
Build a short music video from a song theme — N keyframes, animate each, generate matching music.
Why this skill is useful
Adds a complete executable workflow for generating animated music videos with specific API commands and parameters.
What it needs
Requires muapi installed locally. Requires muapi account access. About 2k tokens when loaded. Last updated 2026-08-04. 3,990 stars on the source repository.
What this skill does
Music Video Build a short music video from a song theme — N keyframes, animate each, generate matching music. Inputs Name Type Required Default Description :--- :--- :--- :--- :--- theme text yes — Song / video theme (e.g. "lonely robot finds a friend, hopeful"). scenes int no 3 Number of scenes (each becomes a 5s clip). musicstyle text no ambient cinematic, instrumental, slow tempo, warm Suno-style tags for the soundtrack. visualstyle text no cinematic, photoreal, soft volumetric light, 16:9 Steps Build one the plan covering: 1. Layer A (parallel) — N keyframes + 1 music track all at once. For each scene 1..N: muapi image generate with a beat-specific prompt + {{visualstyle}}, model=nano-banana-pro (these feed video gen). One muapi audio create (kind=music) using {{musicstyle}}, duration = N × 5 + a 2s tail. 2. Layer B (parallel, depends on Layer A) — animate each keyframe. For each scene: muapi video from-image with image=$nX.url, model=veo3.1-image-to-video, duration=5, prompt=scene-specific motion direction. 3. Return: The scene keyframes (asset ids in order). The animation clips (asset ids in order). The music track asset id. A short summary describing the cut order. Notes Keep character continuity by repeating the character description in every scene prompt verbatim. Don't auto-confirm any single video call > 50 cr — those need the user's nod (the loop will prompt automatically). If a scene's muapi video from-image fails after failover, fall back to muapi video generate (text-to-video) for that scene only. Trigger Keywords music video, mv, video story, song visualization --- Notes for the Executing Agent This recipe is LLM-orchestrated: read each phase, gather any missing inputs from the user, then call muapi CLI commands. Use muapi auth configure first if MUAPIAPIKEY is unset. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills samuraigpt/music-video