Extensions/MiniMax Prompt Skills
ComfyUI Extension

MiniMax Prompt Skills

Apply local prompt skills for MiniMax H3 video prompts and Music 3 music descriptions in ComfyUI. Text generation requires an external API key.

By leisongde·Created 4 days ago·Updated a day ago· 0
leisongde/ComfyUI-MiniMax-prompt
Nodes—
On cloudLocal install
Stars0
Updateda day ago
Readme

ComfyUI MiniMax Prompt Skills

独立的 ComfyUI 自定义节点,用于自动发现本地提示词 skill,以及加载 MiniMax Music 3 官方 skill, 默认通过 https://api.lumuyi.online OpenAI-compatible Chat Completions 中转站 生成提示词或音乐描述文本。

插件代码采用 MIT 许可证,可免费使用、修改、分发和商用。 附带的第三方 Skill 保留各自许可,详见第三方内容与许可证。 在线模型和中转站可能收取 API 调用费用。

大模型服务与 API Key

  • 使用默认服务:如需通过大模型生成提示词或优化音乐描述,请前往 api.lumuyi.online 购买 API Key,并填入节点的 API 密钥。 插件本身免费开源,API 调用费用按服务方规则收取。
  • 停用大模型功能:不需要大模型优化时,可在 ComfyUI 中禁用或移除对应节点, 改为手动输入提示词。
  • 自行修改接口地址:支持自行接入兼容 OpenAI Chat Completions 的服务。

安装

在 ComfyUI 的 custom_nodes 目录中克隆本项目:

git clone https://github.com/leisongde/ComfyUI-MiniMax-prompt.git

使用运行 ComfyUI 的 Python 安装依赖:

python -m pip install -r ComfyUI-MiniMax-prompt/requirements.txt

Windows 便携版可在 ComfyUI_windows_portable 根目录运行:

.\python_embeded\python.exe -m pip install -r .\ComfyUI\custom_nodes\ComfyUI-MiniMax-prompt\requirements.txt

重启 ComfyUI 并刷新浏览器,在节点菜单中搜索 MiniMax,添加提示词或 Music 3 节点。 填写中转站 API 密钥,选择模型及 Skill 后即可生成文字。无需下载模型权重。

更新时,在插件目录执行 git pull,安装依赖后重启 ComfyUI。

提示词 Skill 节点

节点名称:MiniMax Skill 提示词(自动识别)

  • API 密钥:填写中转站 Key。
  • Skill:自动扫描 skills/ 中所有包含 SKILL.md 的文件夹,支持官方和自定义 skill。 选项显示技能名称和目录 ID,名称优先读取 meta.yaml 的 display-name-zh,其次读取 agents/openai.yaml 的 interface.display_name,再使用 SKILL.md 一级标题或文件夹名。
  • 导演:位于 Skill 下方,可选自动选择、战斗导演、文戏表演、镜头与分镜、段缝连续性、 FACS 微表情、全流程导演。默认自动选择,按创意匹配需要的专业规则。
  • 动作强度:位于导演下方,可选 R1 写实克制、R2 商业高燃(默认)、R3 玄幻大招。 选择会随请求传给模型,调整已有动作的幅度、节奏和受力表现。
  • 用户提示词:输入简单创意、产品资料或视频需求。
  • 模型:填写 API 密钥后自动读取中转站 /v1/models,下拉框显示真实模型 ID,过滤生图模型。
  • H3 模式:对 H3 提示词 skill 选择 T2VA、I2VA、FL2VA、L2VA 或 Ref2VA。
  • 补充上下文:可选的时长、画幅、参考素材描述等。
  • 额外要求:可选的本次输出要求。

输出为一个 STRING,可以连接到其它接收文本的节点。

节点同时保留旧版工作流中的英文 Skill 名称、模型 ID 和 H3 模式值,避免升级后出现 Value not in list 校验错误;旧版中文 Skill 名称也继续有效。节点内部类型和输入键保持兼容。 加载旧工作流时,会自动为新增的两行补上默认值,保留原有控件内容。

导演专业规则来自本地 minimax-h3-short-drama-director/references/,手动选择时按专项加载, 自动选择时按创意、上下文和额外要求匹配。所选 Skill 决定目标模型和输出格式,导演规则 提供创作指导。动作强度只作用于已有动作,文戏不会因为默认 R2 而被强加战斗。

模型列表会在填写或修改密钥、打开工作流时自动更新,也可右键节点选择“刷新上游模型列表”。 仍在上游列表中的已选模型会保留;原来的中文模型选项会转换为对应 ID。读取失败时可在 模型控件提示中查看原因,再通过右键菜单重试。能识图的文字模型仍可选择,生成图片的 模型按名称、输出模态及上游能力标记过滤。密钥只随请求发送,不写入模型列表缓存。 codex-auto-review 已排除,不会出现在两个节点的模型列表中。

添加 Skill

将新 skill 放入插件的 skills/ 目录,例如:

skills/
  my-new-skill/
    SKILL.md
    agents/openai.yaml       # 可选:技能显示名称
    references/template.md   # 可选:参考规则

首次更新插件代码后重启 ComfyUI。以后添加、删除或修改 skill 后,刷新浏览器页面即可 更新下拉选项,无需修改 Python 列表或再次重启 ComfyUI。支持按子目录分组放置 skill。 同名技能通过目录 ID 区分。执行时重新扫描目录,仅读取所选 skill 及其 references/ 中的文本文件(包括子目录),不会将全部 skill 一起发送。H3 Prompt Writing 仍按所选 H3 模式加载对应指南;其它 skill 按自身规则决定目标模型和输出格式。节点只生成文本。

Music 3 节点

节点名称:MiniMax Music 3 官方音乐描述优化

  • API 密钥:填写中转站 Key。
  • 音乐描述:必填的简短曲风、情绪、节奏、人声或编曲需求。
  • 主风格:自动判断,或手动选择官方定义的 18 个风格族之一。
  • 融合风格:可选的第二风格族,只用于明确的风格融合。
  • 输出格式:官方三段式结构化文本、JSON 或 JSONL;默认英文,明确要求时可使用其它语言。
  • 模型:与提示词节点一样,自动读取中转站模型列表并过滤生图模型。
  • 歌词:可选;歌词用于判断情绪和段落,最终音乐描述不会复述歌词正文。
  • 补充要求:可选的长度、排除项、乐器、速度、人声或制作方向。
  • 自动整理歌词标签:默认开启。无标签歌词会自动添加 [Verse]、[Chorus]、 [Bridge]、[Outro] 等结构标签,并校验歌词正文、顺序和标点没有被改动。

节点提供两个相互独立的 STRING 输出:

  • 最终音乐描述:连接到 Music 3 生成节点上方的音乐描述输入。
  • 结构化歌词:带段落标签但不改写正文,连接到 Music 3 生成节点下方的歌词输入。

节点按照官方的渐进加载流程工作:先读取风格路由,只打开最多两个风格索引, 由模型选出最多三个参考模板,再生成最终描述。不会一次性扫描或发送全部 1000 个模板。 自动判断主风格通常使用三次 API 请求;手动指定主风格通常使用两次。无标签歌词自动 整理会再使用一次请求,已有标签或关闭整理时不会增加该请求。输出不符合官方规范时会 自动修正一次。

该节点只负责生成 Music 3 的 instructions 文本,不会直接生成音乐。实际调用 Music 3 生成接口时,应把 最终音乐描述 作为 instructions,把 结构化歌词 作为 input。

Skill 文件

skills/ 目录保存官方和用户自行添加的 skill。MiniMax Music 3 专用节点继续使用 music-caption-rewriter、18 个风格索引和 1000 个文本模板;音乐描述任务建议使用该 专用节点,以保留风格路由和模板选择流程。依赖 MiniMax Hub 或其它外部工具的 skill 在提示词节点中只生成文本方案,不会执行工具、脚本或生成媒体。

Music 3 数据来自官方 MiniMax-AI/MiniMax-Music3 仓库的 music-caption-rewriter skill。

安全提示

ComfyUI 工作流可能保存节点控件值。分享工作流前请删除真实 API Key,或改用不保存 在工作流中的本机配置方式。

请勿提交 .env、本机凭据或 config.local.json。这些文件以及 Python 编译缓存已加入 .gitignore;工作流文件中的密钥仍需在分享前手动清空。

许可证

本项目原创插件代码使用 MIT,允许免费使用、修改、分发和商用,分发时需 保留版权和许可声明。

第三方 Skill 分别保留 MIT、Apache-2.0、CC BY 4.0 或 MiniMax 社区许可。 其中 MiniMax 官方内容有独立的商用及适用地区等条件,不属于根目录 MIT 授权范围。 完整来源、许可范围与原文见 THIRD_PARTY_NOTICES.md 和 NOTICE。

维护者发布

发布到 Comfy Registry 的配置和操作步骤见 PUBLISHING.md。