# Muapi Music Video

> Build a short music video from a song theme — N keyframes, animate each, generate matching music.

- **Type:** Skill
- **Install:** `agentstack add skill-samuraigpt-generative-media-skills-music-video`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [SamurAIGPT](https://agentstack.voostack.com/s/samuraigpt)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [SamurAIGPT](https://github.com/SamurAIGPT)
- **Source:** https://github.com/SamurAIGPT/Generative-Media-Skills/tree/main/library/motion/music-video
- **Website:** https://muapi.ai?utm_source=github&utm_medium=about&utm_campaign=generative-media-skills

## Install

```sh
agentstack add skill-samuraigpt-generative-media-skills-music-video
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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). |
| `music_style` | text | no | ambient cinematic, instrumental, slow tempo, warm | Suno-style tags for the soundtrack. |
| `visual_style` | 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 +
     `{{visual_style}}`, model=nano-banana-pro (these feed video gen).
   - One `muapi audio create` (kind=music) using `{{music_style}}`, 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 `MUAPI_API_KEY` is unset.
- For model IDs without a CLI alias yet, fall back to the raw endpoint via `curl -X POST https://api.muapi.ai/api/v1/ -H "x-api-key: $MUAPI_API_KEY" -H 'content-type: application/json' -d '{...}'` and poll with `muapi predict wait `.
- Substitute `{{input_name}}` placeholders with the user's actual inputs before issuing each call.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [SamurAIGPT](https://github.com/SamurAIGPT)
- **Source:** [SamurAIGPT/Generative-Media-Skills](https://github.com/SamurAIGPT/Generative-Media-Skills)
- **License:** MIT
- **Homepage:** https://muapi.ai?utm_source=github&utm_medium=about&utm_campaign=generative-media-skills

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-samuraigpt-generative-media-skills-music-video
- Seller: https://agentstack.voostack.com/s/samuraigpt
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.