ACE++: una versátil herramienta de código abierto para la edición local precisa de imágenes con comandos de texto

Introducción general

ACE++ 是由阿里巴巴通义实验室（Tongyi Lab）的 ali-vilab 团队开发的一个开源项目。它基于 FLUX.1-Fill-dev 模型，旨在通过简单的文字指令实现图像生成和编辑。项目将参考图像生成、局部编辑和可控生成统一在一个框架内，提供三种 LoRA 模型（肖像、物体、局部编辑）和一个更通用的 FFT 模型。用户可以免费从 GitHub 下载代码和模型，最近更新时间为 2025 年 3 月 11 日。ACE++ 适合开发者、设计师和普通用户，既支持命令行操作，也能在 ComfyUI 中使用。

ACE++ 在换脸、换装中对比专用工具没有明显短板，由于最近推出的 Gemini 2.0 Flash 十分亮眼，也是主打文本指令控制图像局部编辑，他们二者效果可以自行对比。

Lista de funciones

• 指令生成图像：输入文字描述生成新图像，例如“一个穿警服的女孩”。
• 局部图像编辑：修改图片指定区域，比如替换背景或调整服装。
• 参考图像生成：基于一张参考图生成相似风格的新图。
• Selección multimodelo：提供肖像、物体、局部编辑三种 LoRA 模型和一个 FFT 模型。
• ComfyUI 支持：通过图形界面操作，简化工作流程。
• Formación a medida：用户可以用自己的数据训练模型，适配特定任务。
• Funciones avanzadas：支持超分辨率、换脸、物体替换等扩展应用。

Utilizar la ayuda

Proceso de instalación

ACE++ 需要配置环境才能运行。以下是详细步骤：

1. Preparar el entorno
   • 确保电脑安装 Python 3.8 或以上版本，可用 python --version Compruébalo.
   • 安装 Git，Windows 用户从官网下载，Mac 用户运行 brew install git.
   • 推荐使用 NVIDIA GPU，至少 12GB 显存，CPU 也能运行但速度慢。
2. Descargar código
   • Abre un terminal y ejecútalo:

     git clone https://github.com/ali-vilab/ACE_plus.git
     cd ACE_plus
     

   • 这会下载项目到本地。
3. Instalación de dependencias
   • 输入命令安装所需库：

     pip install -r repo_requirements.txt
     

   • 如遇权限问题，加 --user Parámetros.
4. Descargar modelos
   • ACE++ 依赖 FLUX.1-Fill-dev 模型，设置环境变量：

     export FLUX_FILL_PATH="hf://black-forest-labs/FLUX.1-Fill-dev"
     

   • 下载 LoRA 模型（可选）：

     export PORTRAIT_MODEL_PATH="hf://ali-vilab/ACE_Plus@portrait/comfyui_portrait_lora64.safetensors"
     export SUBJECT_MODEL_PATH="hf://ali-vilab/ACE_Plus@subject/comfyui_subject_lora16.safetensors"
     export LOCAL_MODEL_PATH="hf://ali-vilab/ACE_Plus@local_editing/comfyui_local_lora16.safetensors"
     

   • FFT 模型（可选）：

     export ACE_PLUS_FFT_MODEL="ms://iic/ACE_Plus@ace_plus_fft.safetensors"
     

   • 可从 Hugging Face 或 ModelScope 手动下载，放入项目目录。
5. prueba de funcionamiento
   • 运行以下命令检查环境：

     python infer_lora.py
     

   • 若输出正常，说明安装成功。

Cómo utilizar las principales funciones

指令生成图像

• procedimiento::
  1. 输入文字描述，如“一只白色的老猫头鹰”。
  2. Corriendo:

     python infer_lora.py --prompt "1 white old owl"
     

  3. Los resultados se guardan en el archivo output Carpeta.
• llamar la atención sobre algo：描述越详细，效果越好。FFT 模型适合复杂任务。

局部图像编辑

• procedimiento::
  1. 准备图片（如 example.jpg）和掩码（如 mask.png），掩码白色区域为编辑部分。
  2. Corriendo:

     python infer_lora.py --image example.jpg --mask mask.png --prompt "add a red hat"
     

  3. 编辑后的图片自动保存。
• finura：掩码可用画图工具制作，确保区域清晰。

参考图像生成

• procedimiento::
  1. 准备参考图片（如 ref.jpg).
  2. 输入描述，如“草原上的男孩，保持相同风格”。
  3. Corriendo:

     python infer_lora.py --ref ref.jpg --prompt "a boy on the grassland in the same style"
     

  4. 结果保留参考图风格。
• sugerencia：参考图风格明显时效果最佳。

使用 ComfyUI

• Instalar ComfyUI::
  1. 下载 ComfyUI：

     git clone https://github.com/comfyanonymous/ComfyUI.git
     

  2. 将 ACE++ 模型放入 ComfyUI/models Carpeta.
  3. Lanzamiento:

     cd ComfyUI
     python main.py
     

• plataforma::
  1. Abra su navegador y visite http://localhost:8188.
  2. 导入 ACE++ 工作流（位于 workflow/ComfyUI-ACE_Plus).
  3. 上传图片或输入文字，按界面提示调整参数，点击运行。
• vantage：图形界面适合新手，操作更直观。

Formación a medida

• Preparar los datos::
  1. consulta data/train.csv，准备训练数据，格式为：

     edit_image,edit_mask,ref_image,target_image,prompt,data_type
     

  2. 字段说明：编辑任务填 edit_image responder cantando mask，参考生成填 ref_image.
• entrenamiento de running::
  1. configure train_config/ace_plus_lora.yaml，调整参数。
  2. Corriendo:

     python run_train.py --cfg train_config/ace_plus_lora.yaml
     

  3. 训练模型保存在 examples/exp_example.

Función destacada Operación

LoRA 模型切换

• metodologías::
  1. 设置环境变量，如用肖像模型：

     export MODEL_PATH="hf://ali-vilab/ACE_Plus@portrait/comfyui_portrait_lora64.safetensors"
     

  2. estar en movimiento infer_lora.py，效果偏向肖像优化。
• utilice：肖像模型适合人脸，物体模型适合物品，局部编辑模型适合区域调整。

FFT 模型使用

• metodologías::
  1. 设置：

     export ACE_PLUS_FFT_MODEL="ms://iic/ACE_Plus@ace_plus_fft.safetensors"
     

  2. Corriendo:

     python infer_fft.py
     

• especificidades：支持更多任务，但性能可能不如 LoRA 稳定，适合学术研究。

高级应用

• trasplante de cara::
  1. 准备参考人脸和目标图片。
  2. 用 ComfyUI flujo de trabajo ACE_Plus_FFT_workflow_referenceediting_generation.json，输入指令如“男人面向镜头”。
• 超分辨率::
  1. gasto o desembolso ACE_Plus_FFT_workflow_no_preprocess.json，输入低分辨率图和描述。
  2. 输出高清图像。

escenario de aplicación

1. 个性化头像设计
   用户输入描述或上传照片，生成卡通头像，如“戴眼镜的笑脸女孩”。
2. 电商商品优化
   商家编辑商品图，比如将衣服改成蓝色，添加背景，提升购买率。
3. 电影海报制作
   用换脸功能替换演员面孔，或调整海报元素，快速生成创意设计。

CONTROL DE CALIDAD

1. ACE++ 免费吗？
   是的，ACE++ 是开源项目，代码和模型免费提供，可从 GitHub 下载。
2. ¿Qué ocurre si aparece un error de ejecución?
   检查 Python 版本、依赖安装和模型路径。若无法解决，在 GitHub Issues 提交问题。
3. FFT 模型和 LoRA 模型哪个更好？
   LoRA 模型在特定任务上更稳定，FFT 模型更通用但性能可能下降，推荐根据需求选择。