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等支持参考输入的模型。

核心功能
- 角色文件读写:加载/保存
.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生成是音色近似复刻,不是原声音精准复制。
典型工作流
- 上传脸部、身体、服装参考图,Encode Character打包生成
.char角色 - FLUX.2 Klein9B:参考转为latent,生成静态图,人物形象保持统一
- MiniMax H3:编号槽传入参考图,生成人物视频
- 进阶:添加人声参考,生成带固定音色的人物说话视频
许可证说明
- omnichar-sdk:Apache-2.0,闭源软件也可以读取
.char角色文件 - 插件其余代码:GPL-3.0-or-later,适配ComfyUI协议
© 版权声明
文章版权归作者所有,未经允许请勿转载。















