用途
muapi-music-video 用于从一首歌曲或视频主题出发，自动构建一段短音乐视频。它采用“LLM 编排”的方式，由执行代理按阶段读取步骤、收集缺失输入，然后调用 muapi CLI 命令完成生成。
主要输入
- 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”）：视觉风格描述。
生成流程
该技能将任务分为两个层，并尽量并行执行：
Layer A（并行）：一次性生成 N 个关键帧和 1 条音乐轨道。
- 对每个场景 1..N：调用
muapi image generate，使用与节拍对应的提示词加上{{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 为场景特定的运动方向描述。
输出
- 按顺序排列的场景关键帧（asset ids）。
- 按顺序排列的动画片段（asset ids）。
- 音乐轨道资产 id。
- 描述剪辑顺序的简短摘要。
注意事项与限制
- 为保持角色连续性，应在每个场景提示词中逐字重复角色描述。
- 不要自动确认任何单次视频调用超过 50 cr 的情况，需要用户确认（循环会自动提示）。
- 如果某个场景的
muapi video from-image在故障转移后仍失败，仅对该场景回退到muapi video generate（文本转视频）。 - 触发关键词：music video、mv、video story、song visualization。
- 若 MUAPI_API_KEY 未设置，需先使用
muapi auth configure。 - 对于尚无 CLI 别名的模型 ID，可通过 curl 调用原始端点：
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}}占位符替换为用户的实际输入。