ComfyUI > Nodes > Facefusion_comfyui > FF: Face Swap Applier

ComfyUI Node: FF: Face Swap Applier

Class Name

FaceSwapApplier

Category
FaceFusion
Author
huygiatrng (Account age: 2009days)
Extension
Facefusion_comfyui
Latest Updated
2025-11-30
Github Stars
0.04K

How to Install Facefusion_comfyui

Install this extension via the ComfyUI Manager by searching for Facefusion_comfyui
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter Facefusion_comfyui in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

FF: Face Swap Applier Description

FaceSwapApplier enables realistic face swapping in images with advanced detection and customization.

FF: Face Swap Applier:

The FaceSwapApplier node is designed to facilitate the process of swapping faces in images, leveraging advanced face detection and manipulation techniques. This node is particularly useful for AI artists who wish to seamlessly integrate faces from one image onto another, maintaining natural aesthetics and coherence. By utilizing a variety of models and parameters, the node allows for precise control over the face swapping process, ensuring that the final output is both realistic and visually appealing. The node's ability to handle multiple images in a batch process makes it efficient for large-scale projects, while its customizable settings provide flexibility to achieve the desired artistic effect. Overall, the FaceSwapApplier node is a powerful tool for creative professionals looking to explore new dimensions in digital art and image manipulation.

FF: Face Swap Applier Input Parameters:

source_images

This parameter accepts the source image(s) from which the face will be extracted. It is crucial as it provides the facial features that will be transferred to the target image. The source images should be of high quality to ensure a successful face swap.

target_face_data

This parameter contains the data of the target face(s) detected in the image, including the image itself and the facial landmarks. It is essential for identifying the specific face in the target image where the swap will occur.

api_token

The api_token is a string used for authentication purposes. It ensures that the face swapping process is authorized and secure. The default value is -1, indicating that no token is provided by default.

face_swapper_model

This parameter allows you to select the model used for the face swapping process. Options include hyperswap_1a_256, hyperswap_1b_256, and hyperswap_1c_256, with hyperswap_1c_256 as the default. Each model may offer different levels of detail and processing speed.

pixel_boost

The pixel_boost parameter determines the resolution enhancement applied to the face swap. Options range from 256x256 to 1024x1024, with 512x512 as the default. Higher resolutions can improve the quality of the swap but may require more processing power.

face_occluder_model

This parameter specifies the model used to handle occlusions in the face swap process. Options include none, xseg_1, xseg_2, and xseg_3, with xseg_1 as the default. The choice of model can affect how well the swap handles obstructions like hair or glasses.

face_parser_model

The face_parser_model parameter determines the model used for parsing facial regions. Options include none, bisenet_resnet_18, and bisenet_resnet_34, with bisenet_resnet_34 as the default. This model helps in accurately mapping facial features during the swap.

face_mask_blur

This parameter controls the amount of blur applied to the face mask, which can help blend the swapped face with the target image. It is a float value ranging from 0.0 to 1.0, with a default of 0.3. Adjusting this value can enhance the natural appearance of the swap.

face_index

The face_index parameter specifies which face in the target image to swap, in cases where multiple faces are detected. It is an integer value ranging from 0 to 100, with a default of 0. This allows for precise targeting of the desired face in multi-face images.

FF: Face Swap Applier Output Parameters:

swapped_image

The swapped_image is the final output image with the face swap applied. It reflects the integration of the source face onto the target image, showcasing the effectiveness of the face swapping process.

face_data

The face_data output provides information about the faces detected and processed in the target image. This data can be useful for further analysis or adjustments in subsequent processing steps.

FF: Face Swap Applier Usage Tips:

  • Ensure that the source and target images are of high quality and have similar lighting conditions to achieve the best results.
  • Experiment with different face_swapper_model and pixel_boost settings to find the optimal balance between processing speed and output quality.
  • Use the face_mask_blur parameter to fine-tune the blending of the swapped face with the target image, especially if the initial result appears unnatural.

FF: Face Swap Applier Common Errors and Solutions:

No faces in face_data to swap

  • Explanation: This error occurs when no faces are detected in the target image data provided.
  • Solution: Ensure that the target image contains clear and unobstructed faces. You may need to adjust the face detection settings or use a different image.

Face index <face_index> out of range (only <number_of_faces> faces detected)

  • Explanation: The specified face_index exceeds the number of faces detected in the target image.
  • Solution: Adjust the face_index to a valid number within the range of detected faces, or verify that the target image contains the expected number of faces.

FF: Face Swap Applier Related Nodes

Go back to the extension to check out more related nodes.
Facefusion_comfyui
RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.