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.
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。