easel/advanced-face-swap

Face swap one or two people into a target image

Capabilities

No capability data available

Community model (estimated from hardware time)

Name	Type	Description	Default	Constraints
`swap_image` *	string (uri)	The face image to swap from	`—`	—
`target_image` *	string (uri)	The image to swap onto	`—`	—
`hair_source`	string	Choose whose hairstyle to preserve: 'user' preserves hairstyle from face image, 'target' preserves from target image	`"user"`	user target
`swap_image_b`	string (uri)	Optional second face image to swap from	`—`	—
`user_b_gender`	string	Optional description of second user's gender for multi-user swaps	`"default"`	default a man a woman a nonbinary person
`user_gender`	string	Optional description of user gender ('a man', 'a woman', 'nonbinary person'), used for multi-user swaps	`"default"`	default a man a woman a nonbinary person

swap_image required string

The face image to swap from

target_image required string

The image to swap onto

hair_source string

Choose whose hairstyle to preserve: 'user' preserves hairstyle from face image, 'target' preserves from target image

Default: "user"

user target

swap_image_b string

Optional second face image to swap from

user_b_gender string

Optional description of second user's gender for multi-user swaps

Default: "default"

default a man a woman a nonbinary person

user_gender string

Optional description of user gender ('a man', 'a woman', 'nonbinary person'), used for multi-user swaps

Default: "default"

default a man a woman a nonbinary person

Version: 602d8c526aca Updated: 2/26/2026 218.3K runs