mcpField
M
muapi-storyboard

muapi-storyboard

github.com/samuraigpt创意与媒体25686 次安装4 周前更新
代码仓库

关于 muapi-storyboard

muapi-storyboard 是由 Agent 执行的图像分镜流程,可根据故事梗概生成关键帧。它将梗概拆分为有序的场景情节,并行生成画面,并通过描述保持视觉元素一致。

主要功能

  1. 01将故事梗概拆分为情节节点
  2. 02设置关键帧数量和视觉风格
  3. 03使用 muapi 生成 16:9 图像关键帧
  4. 04并行执行关键帧生成
  5. 05按场景顺序返回素材 ID 和说明

适用场景

  1. 01为短篇故事制作关键帧
  2. 02规划一组连续的视觉场景
  3. 03生成分镜参考图

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/samuraigpt/generative-media-skills --skill muapi-storyboard

安装后在 Claude Code 中输入/muapi-storyboard确认已加载。

详细介绍

分镜生成器

为短篇故事或场景序列生成 N 个关键帧(仅图像,不生成视频)。

输入

名称类型必填默认值描述
premisetext是—一句话故事梗概(例如:“孤独的机器人找到了一只小小的机械鸟朋友”)。
scenesint否6要生成的关键帧数量。
styletext否cinematic, photoreal, soft lighting, 16:9应用于每个关键帧的视觉风格标签。

步骤

使用计划,在单个并行层中调度全部 N 个关键帧。

  1. 将 premise 分解为 {{scenes}} 个故事节拍,形成清晰的弧线: 开端 → 引发事件 → 情节升级 → 高潮 → 结局。
    • 每个节拍都配有一段视觉描述。
    • 确保各个节拍中的角色/物体保持连贯(角色外观相同,世界设定相同)。
  2. 为每个节拍创建一个 muapi image generate 节点(model=nano-banana-2, aspect_ratio=16:9):
    • Prompt = "<beat description>. {{style}}"。
    • Tier:balanced(这些是参考关键帧,不是最终成品)。
    • 宽高比:16:9。
  3. 并行运行计划(关键帧之间不设置 depends_on)。
  4. 按节拍顺序返回资源 ID,并为每个场景附上一行说明。

注意事项

  • 不要添加动画、放大图像或添加音频——此技能仅生成关键帧。 如果用户想要视频,之后建议使用 music-video 技能。
  • 为保持一致性,请在每个提示词中逐字重复角色描述(“一台锈迹斑斑的小型人形机器人……”),不要依赖模型自行记住。

触发关键词

storyboard, keyframes, scene sequence, story panels


执行 Agent 注意事项

  • 此配方由 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}} 占位符替换为用户的实际输入。

评论

支持 Markdown