用途
muapi-music-video 是一个用于从歌曲主题生成短视频音乐视频（Music Video）的技能配方。它把一个主题拆解为多个场景，为每个场景生成关键帧并动画化，同时生成与主题匹配的音乐音轨。触发关键词包括：music video、mv、video story、song visualization。
输入参数
- theme（文本，必填）：歌曲/视频主题，例如“lonely robot finds a friend, hopeful”。
- scenes（整数，可选，默认 3）：场景数量，每个场景会生成一段 5 秒片段。
- music_style（文本，可选，默认“ambient cinematic, instrumental, slow tempo, warm”）：用于配乐的 Suno 风格标签。
- visual_style（文本，可选，默认“cinematic, photoreal, soft volumetric light, 16:9”）：视觉风格。
主要能力与步骤
整体由 LLM 编排执行，分为两层：
Layer A（并行）——一次性生成 N 个关键帧和 1 条音乐轨。
- 对每个场景 1..N：调用 muapi image generate，使用针对节拍的提示词（prompt）加 {{visual_style}}，模型为 nano-banana-pro，这些图用于后续视频生成。
- 调用一次 muapi audio create（kind=music），使用 {{music_style}}，时长为 N × 5 秒再加 2 秒尾音。
Layer B（并行，依赖 Layer A）——对每个关键帧做动画。
- 对每个场景：调用 muapi video from-image，参数 image=$nX.url，模型 veo3.1-image-to-video，duration=5，prompt 为场景特定的运动方向描述。
返回结果
- 按顺序排列的场景关键帧（资产 ID）。
- 按顺序排列的动画片段（资产 ID）。
- 音乐轨资产 ID。
- 描述剪辑顺序的简短摘要。
使用方式
该配方由 LLM 编排：阅读每个阶段，向用户收集缺失的输入，然后调用 muapi CLI 命令。若 MUAPI_API_KEY 未设置，先使用 muapi auth configure。对于尚无 CLI 别名的模型 ID，可通过原始端点回退：curl -X POST https://api.muapi.ai/api/v1/<endpoint> -H "x-api-key: $MUAPI_API_KEY" -H 'content-type: application/json' -d '{...}'，并用 muapi predict wait <request_id> 轮询。在发起每次调用前，需将 {{input_name}} 占位符替换为用户实际输入。
注意事项与限制
- 角色连续性：在每个场景提示中逐字重复角色描述。
- 不要自动确认任何单个超过 50 cr 的视频调用，这些需要用户同意（循环会自动提示）。
- 若某场景的 muapi video from-image 在故障转移后仍失败，可仅对该场景回退为 muapi video generate（文生视频）。