%20(1).png)
ComfyUI-InstantCharacter 插件完全教程
1. 插件简介
插件地址： https://github.com/jax-explorer/ComfyUI-InstantCharacter
这个插件就像是给 ComfyUI 装了一个"角色复制机"！它能让你上传一张人物照片，然后让这个人物出现在各种不同的场景里，做各种不同的动作，而且还能保持这个人的长相特征不变。
比如说，你有一张朋友的照片，用这个插件就能让你朋友"穿越"到古代当皇帝、在太空当宇航员、在海边冲浪等等，而且生成的图片里的人看起来还是你朋友的样子！
主要功能：
- 保持人物特征不变的情况下生成新图片
- 支持复杂的文字描述（比如"在雪山上滑雪"、"在咖啡厅里看书"）
- 可以调节人物特征的保持程度
- 支持高质量图片生成（最高 2048x2048）
2. 如何安装
方法一：通过 ComfyUI Manager 安装（推荐）
- 打开 ComfyUI
- 点击右下角的 "Manager" 按钮
- 在搜索框输入 "InstantCharacter"
- 找到插件后点击 "Install" 安装
- 重启 ComfyUI
方法二：手动安装
- 打开终端或命令提示符
- 进入你的 ComfyUI 安装目录下的
custom_nodes文件夹 - 运行命令：
git clone https://github.com/jax-explorer/ComfyUI-InstantCharacter.git - 重启 ComfyUI
重要提醒
- 这个插件需要很大的显存（至少 24GB），如果你的显卡显存不够，可以开启"CPU卸载"功能
- 第一次使用时会自动下载模型文件，需要等待一段时间
- 需要手动下载一个文件到
models/ipadapter文件夹：https://huggingface.co/tencent/InstantCharacter/blob/main/instantcharacter_ip-adapter.bin
3. 节点详细解析
3.1 InstantCharacterLoadModel 节点
这个节点就像是"模型加载器"，负责把生成图片需要的所有工具都准备好，就像厨师开始做菜前要把所有食材和工具都摆好一样。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| HF Token | hf_token | 文本输入 | 你的 Hugging Face 令牌 | 这就像是你的"会员卡号"，用来从网上下载模型 | Hugging Face 平台的访问令牌，用于下载受限模型 | 去 huggingface.co 注册账号，在设置里生成一个 token 填进去 |
| IP Adapter Name | ip_adapter_name | 下拉选择 | instantcharacter_ip-adapter.bin | 选择哪个"人脸识别器"来记住人物特征 | 选择用于人物特征提取的 IP Adapter 模型文件 | 从下拉菜单选择你下载的 .bin 文件 |
| CPU Offload | cpu_offload | 开关 | True（如果显存不够） | 开启后可以节省显卡内存，但会变慢一些 | 启用 CPU 卸载以减少 GPU 显存占用 | 显存少于 45GB 建议开启，24GB 显存勉强够用 |
3.2 InstantCharacterLoadModelFromLocal 节点
这个节点是"本地模型加载器"，如果你已经把模型文件下载到电脑里了，就用这个节点，不用每次都从网上下载，就像用本地的音乐文件而不是在线听歌一样。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| Base Model Path | base_model_path | 文本输入 | models/FLUX.1-dev | 告诉程序主要的"画画模型"放在哪里 | FLUX 基础扩散模型的本地存储路径 | 填写你电脑里 FLUX 模型的文件夹路径 |
| Image Encoder Path | image_encoder_path | 文本输入 | models/google/siglip-so400m-patch14-384 | 第一个"看图识别器"的位置，用来理解图片内容 | SigLIP 图像编码器的本地路径，用于提取图像特征 | 填写 SigLIP 模型的存放路径 |
| Image Encoder 2 Path | image_encoder_2_path | 文本输入 | models/facebook/dinov2-giant | 第二个"看图识别器"的位置，配合第一个更准确 | DINOv2 图像编码器路径，提供更鲁棒的图像特征 | 填写 DINOv2 模型的存放路径 |
| IP Adapter Path | ip_adapter_path | 文本输入 | models/InstantCharacter/instantcharacter_ip-adapter.bin | "人脸记忆器"的位置，专门记住人物长相 | InstantCharacter IP Adapter 权重文件路径 | 填写下载的 IP Adapter 文件完整路径 |
| CPU Offload | cpu_offload | 开关 | True（如果显存不够） | 开启后可以节省显卡内存，但会变慢一些 | 启用 CPU 卸载以减少 GPU 显存占用 | 显存少于 45GB 建议开启 |
3.3 InstantCharacterGenerate 节点
这个节点是真正的"魔法师"，它接收你的指令和人物照片，然后变出你想要的图片，就像阿拉丁神灯里的精灵一样。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| Pipe | pipe | 连接线 | 来自加载节点 | 这是从"模型加载器"传来的"工具箱" | 从模型加载节点传递的管道对象 | 用线连接到上面的加载节点输出 |
| Prompt | prompt | 多行文本 | 详细描述 | 告诉程序你想要什么样的图片，越详细越好 | 文本提示词，描述期望生成的图像内容 | "一个人在海边看日落，穿着白色连衣裙，微风吹动头发" |
| Height | height | 数字 | 768 | 图片的高度，就像照片的长边 | 生成图像的像素高度 | 768 适合大多数情况，可以调到 1024 或更高 |
| Width | width | 数字 | 1024 | 图片的宽度，就像照片的短边 | 生成图像的像素宽度 | 1024 是标准宽度，可以根据需要调整 |
| Guidance Scale | guidance_scale | 小数 | 3.5 | 控制程序多听话，数字越大越严格按你的要求做 | 分类器自由引导强度，控制文本提示的影响程度 | 3.5 是平衡值，太高可能过度拟合，太低可能偏离提示 |
| Num Inference Steps | num_inference_steps | 整数 | 28 | 程序"思考"多少次才出结果，次数越多质量越好但越慢 | 扩散过程的推理步数，影响生成质量和速度 | 28 是好的平衡点，可以降到 20 加速或升到 50 提质 |
| Seed | seed | 整数 | 0 | 随机数种子，相同种子会产生相似结果 | 随机数生成器种子，用于结果复现 | 0 表示随机，固定数字可以重复生成相似图片 |
| Subject Scale | subject_scale | 小数 | 0.9 | 控制保持人物特征的强度，越高越像原图人物 | 主体特征保持强度，控制人物相似度 | 0.9 较强保持特征，0.5 较弱，1.0 最强但可能僵硬 |
| Subject Image | subject_image | 图片输入 | 可选 | 上传你想要"复制"的人物照片 | 输入的参考人物图像，用于特征提取 | 连接图片加载节点，或直接拖拽图片到工作流 |
4. 使用技巧和建议
4.1 人物照片选择技巧
- 清晰度要高：就像拍身份证照片一样，人脸要清楚
- 光线要好：避免阴影遮挡脸部，自然光最佳
- 角度要正：正面或稍微侧面的角度效果最好
- 背景要简单：纯色背景或简单背景，避免复杂场景干扰
4.2 提示词编写技巧
- 越详细越好：不要只写"一个人"，要写"一个穿红色毛衣的人在公园里散步"
- 分层描述：先写人物动作，再写环境，最后写风格
- 避免冲突：不要在一句话里要求太多相互矛盾的内容
- 使用英文：英文提示词通常效果更好
4.3 参数调节建议
- 新手设置：guidance_scale=3.5, steps=28, subject_scale=0.9
- 追求质量：steps=50, guidance_scale=4.0
- 追求速度：steps=20, guidance_scale=3.0
- 显存不够：开启 cpu_offload，降低分辨率到 512x768
4.4 常见问题解决
- 生成的人不像原图：提高 subject_scale 到 1.0-1.2
- 图片质量不好：增加 num_inference_steps 到 40-50
- 生成太慢：开启 cpu_offload 或降低分辨率
- 显存不足：必须开启 cpu_offload，关闭其他占显存的程序
5. 常见问题解答
Q1：为什么第一次使用这么慢？
A： 就像第一次安装游戏要下载很多文件一样，插件需要从网上下载好几个大模型文件（总共约 20GB），下载完后就快了。
Q2：我的显卡显存只有 8GB，能用吗？
A： 很遗憾，这个插件至少需要 24GB 显存才能运行，8GB 显存无法使用。建议使用云端 GPU 服务。
Q3：生成的人物和原图差别很大怎么办？
A：
- 检查原图质量，确保人脸清晰
- 提高 subject_scale 参数到 1.0 或更高
- 简化提示词，避免过于复杂的描述
- 尝试不同的 seed 值
Q4：可以同时处理多个人物吗？
A： 目前这个插件主要针对单个人物设计，多人物效果可能不理想。
Q5：支持哪些图片格式？
A： 支持常见的 JPG、PNG、WEBP 等格式，建议使用 PNG 格式以保证质量。
6. 进阶使用技巧
6.1 工作流搭建建议
- 基础流程：图片加载 → 模型加载 → 生成 → 保存
- 批量处理：使用循环节点处理多张图片
- 后处理优化：连接放大、锐化等节点提升质量
- 风格融合：结合 LoRA 节点添加特定风格
6.2 性能优化
- 内存管理：及时清理不用的节点，避免内存泄漏
- 批处理设置：单次处理不要超过 4 张图片
- 模型缓存：重复使用时不要重新加载模型
6.3 创意应用场景
- 虚拟写真：为自己或朋友制作各种风格的写真照
- 角色扮演：让自己变身成电影角色、历史人物
- 场景穿越：在不同的时代、地点留下"足迹"
- 服装试穿：虚拟试穿不同风格的服装
7. 注意事项和免责声明
7.1 使用注意事项
- 尊重肖像权：不要使用他人照片进行不当用途
- 内容合规：生成内容应符合法律法规和道德标准
- 版权意识：生成的图片可能涉及版权问题，商用需谨慎
- 隐私保护：不要上传敏感或私密照片
7.2 技术限制
- 硬件要求高：需要高端显卡和大量显存
- 处理时间长：高质量生成需要较长时间
- 效果不稳定：不同照片和提示词效果差异较大
- 风格局限：某些特殊风格可能支持不佳
总结： ComfyUI-InstantCharacter 是一个功能强大的人物图像生成插件，虽然对硬件要求较高，但能够产生令人惊艳的效果。掌握好参数调节和使用技巧，你就能创造出各种有趣的人物图像作品！
记住：多实践、多尝试，每个参数的微调都可能带来意想不到的效果！