faceswap

Swap a face in a target video using HeyGen workflow APIs.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/gyalamanch001a/pur-new --skill faceswap-gyalamanch001a
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: faceswap
Source: https://github.com/gyalamanch001a/pur-new/tree/main/.agents/skills/faceswap
Command: npx skills add https://github.com/gyalamanch001a/pur-new --skill faceswap-gyalamanch001a

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the process of replacing a face in a target video with a source face image, removing the need for manual video editing or specialized compositing tools.

Core Features & Use Cases

  • AI Face Replacement: Submit a source image and a target video to generate a face-swapped result through HeyGen.
  • Workflow Monitoring: Track execution status until the rendered video is ready to download.
  • Practical Uses: Create personalized video messages, localize presenter videos, or produce avatar-driven content with a custom face.

Quick Start

Ask the Skill to swap the face from my provided image into the attached video and return the completed output link.

Frequently Asked Questions about faceswap

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I swap a face into a video using a source image?

To swap a face into a video, submit a source image URL and a target video URL. The process uses HeyGen workflow execution APIs to asynchronously replace the face and return a completed output video link.

Can I use HeyGen for AI video face replacement without manual editing?

Yes, HeyGen supports AI video face replacement without manual editing. By submitting source_image_url and target_video_url inputs to the FaceswapNode workflow, you can automate face replacement and generate personalized videos.

Do I need an API key to perform AI face swaps with HeyGen workflows?

Yes, you need an X-Api-Key for authentication to execute face swap workflows. This API key allows you to submit asynchronous jobs, poll execution status, and retrieve the final face-swapped video output.

How does asynchronous job polling work for personalized video creation?

Asynchronous job polling for personalized video creation tracks the rendering status after you submit face swap inputs. The system monitors the workflow execution until the target video is ready to download as a completed output video_url.

What are the limitations of using AI face replacement for avatar customization?

AI face replacement for avatar customization requires valid source_image_url and target_video_url inputs. As an asynchronous process, it requires status polling until completion, meaning results are not generated instantly during the workflow execution session.