关于 muapi-storyboard
muapi-storyboard 是由 Agent 执行的图像分镜流程,可根据故事梗概生成关键帧。它将梗概拆分为有序的场景情节,并行生成画面,并通过描述保持视觉元素一致。
主要功能
- 01将故事梗概拆分为情节节点
- 02设置关键帧数量和视觉风格
- 03使用 muapi 生成 16:9 图像关键帧
- 04并行执行关键帧生成
- 05按场景顺序返回素材 ID 和说明
适用场景
- 01为短篇故事制作关键帧
- 02规划一组连续的视觉场景
- 03生成分镜参考图
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ samuraigpt/ generative-media-skills --skill muapi-storyboard安装后在 Claude Code 中输入/muapi-storyboard确认已加载。
详细介绍
分镜生成器
为短篇故事或场景序列生成 N 个关键帧(仅图像,不生成视频)。
输入
| 名称 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
premise | text | 是 | — | 一句话故事梗概(例如:“孤独的机器人找到了一只小小的机械鸟朋友”)。 |
scenes | int | 否 | 6 | 要生成的关键帧数量。 |
style | text | 否 | cinematic, photoreal, soft lighting, 16:9 | 应用于每个关键帧的视觉风格标签。 |
步骤
使用计划,在单个并行层中调度全部 N 个关键帧。
- 将
premise分解为{{scenes}}个故事节拍,形成清晰的弧线: 开端 → 引发事件 → 情节升级 → 高潮 → 结局。- 每个节拍都配有一段视觉描述。
- 确保各个节拍中的角色/物体保持连贯(角色外观相同,世界设定相同)。
- 为每个节拍创建一个
muapi image generate节点(model=nano-banana-2, aspect_ratio=16:9):- Prompt =
"<beat description>. {{style}}"。 - Tier:balanced(这些是参考关键帧,不是最终成品)。
- 宽高比:16:9。
- Prompt =
- 并行运行计划(关键帧之间不设置
depends_on)。 - 按节拍顺序返回资源 ID,并为每个场景附上一行说明。
注意事项
- 不要添加动画、放大图像或添加音频——此技能仅生成关键帧。
如果用户想要视频,之后建议使用
music-video技能。 - 为保持一致性,请在每个提示词中逐字重复角色描述(“一台锈迹斑斑的小型人形机器人……”),不要依赖模型自行记住。
触发关键词
storyboard, keyframes, scene sequence, story panels
执行 Agent 注意事项
- 此配方由 LLM 编排:阅读各个阶段,向用户收集任何缺失的输入,然后调用
muapiCLI 命令。如果未设置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}}占位符替换为用户的实际输入。
评论
支持 Markdown