ComfyUI-Omnichar:.char角色文件格式发布,一套角色跨图像视频模型复用

插件1个月前发布 小马良
131 0

ComfyUI-Omnichar 是一套面向AI图像/视频生成的ComfyUI自定义节点,定义了.char可移植角色格式,实现角色一次制作,跨多个图像、视频大模型复用,保证人脸、身材、服饰风格统一。目前支持 MiniMax H3、Krea2、Flux2 dev、klein9B、4B;MiniMax H3还支持角色绑定固定参考音色。

  • GitHub:https://github.com/omnichar/ComfyUI-Omnichar
  • 角色卡制作:https://www.omnichar.org

.char角色包内部封装角色参考图、锁定角色描述,还可内置配套训练LoRA。你可以在Omnichar Studio、Omnichar Cloud或者本地GPU上用Encode Character节点编码生成角色文件,之后直接喂给FLUX.2、MiniMax H3等支持参考输入的模型。

ComfyUI-Omnichar:.char角色文件格式发布,一套角色跨图像视频模型复用

核心功能

  • 角色文件读写:加载/保存.char角色包,支持对接Omnichar Studio共享角色目录
  • 多参考图管理:批量参考图,或者按编号独立槽位调用,参考顺序固定
  • CLIP文本条件:可接入CLIP生成条件,也可直接使用文本提示词
  • LoRA自动加载:角色包内置LoRA时,自动应用到Model与CLIP
  • 角色编码:最多三组脸部、身体、服装参考图,一键打包生成新.char角色
  • 角色音色绑定:角色文件可存入约30秒干净人声片段;在MiniMax H3视频生成时,识别提示词里的对话自动启用参考语音
  • 独立Python SDK:omnichar-sdk,不依赖ComfyUI,其他程序也能读取.char格式

环境与安装

环境要求

  • ComfyUI
  • Python3.10+
  • omnichar-sdk依赖包

安装命令

cd ComfyUI/custom_nodes
git clone https://github.com/omnichar/ComfyUI-Omnichar
cd ComfyUI-Omnichar
pip install -r requirements.txt

安装完成重启ComfyUI。

角色文件存放路径:ComfyUI/models/characters/,加载节点会自动扫描该目录。

如需和Omnichar Studio共用角色文件夹,配置环境变量INLINE_CHARACTERS_DIR指向角色目录即可。

内置节点清单

节点作用
Load Character读取.char角色文件
Decode Character解析角色,输出条件、参考图、角色音色等
Character Reference按索引取出单张参考图
Character References Split拆分最多5张独立参考图像
Character Reference Latent将参考转为latent条件,适配FLUX.2这类模型
Apply Character LoRA加载角色内置LoRA到模型和CLIP
Encode Character上传脸/身体/服装参考,编码生成新角色
Save Character将角色保存为.char文件

音色逻辑(MiniMax H3)

Encode Character的voice输入接入30秒干净无伴奏人声。Decode Character可设置语音模式:

  • auto:提示词存在对话台词时自动传入参考音频;纯画面描述不启用
  • always:强制使用该参考音色
  • never:始终不使用角色声音

注意:H3生成是音色近似复刻,不是原声音精准复制。

典型工作流

  1. 上传脸部、身体、服装参考图,Encode Character打包生成.char角色
  2. FLUX.2 Klein9B:参考转为latent,生成静态图,人物形象保持统一
  3. MiniMax H3:编号槽传入参考图,生成人物视频
  4. 进阶:添加人声参考,生成带固定音色的人物说话视频

许可证说明

  • omnichar-sdk:Apache-2.0,闭源软件也可以读取.char角色文件
  • 插件其余代码:GPL-3.0-or-later,适配ComfyUI协议
© 版权声明

相关文章