faceswap

Swap faces in videos via HeyGen FaceswapNode workflows.

46.2k|5.7k|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/calesthio/OpenMontage --skill faceswap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: faceswap
Source: https://github.com/calesthio/OpenMontage/tree/main/.agents/skills/faceswap
Command: npx skills add https://github.com/calesthio/OpenMontage --skill faceswap

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enable automated, high-quality face replacement in videos so creators can personalize, edit, or retarget faces without manual frame-by-frame compositing or expensive VFX pipelines.

Core Features & Use Cases

  • HeyGen Workflow Execution: Submit a FaceswapNode workflow to HeyGen with a source face image and a target video to perform GPU-accelerated face replacement.
  • Asynchronous Processing & Polling: Track execution status by polling the workflows executions endpoint until the job completes and retrieve the resulting video URL.
  • Chaining & Personalization: Chain with avatar or avatar-generation workflows to generate base footage and then swap in a custom face for personalized messages, demos, or marketing assets.
  • Best Practices: Use a single, front-facing, well-lit source image and expect GPU processing time; poll every ~10 seconds and validate output before distribution.

Quick Start

Use the faceswap skill to replace the face in https://example.com/original.mp4 with the person in https://example.com/face.jpg using your HEYGEN_API_KEY.

Frequently Asked Questions about faceswap

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

FAQPage Schema
How do I replace faces in videos using a source image and a target clip?

To replace faces in videos, you submit a source face image and a target video to the HeyGen FaceswapNode workflow. The API processes the request asynchronously using GPU acceleration, and you poll the execution endpoint until the status is completed to retrieve your output video URL.

Can I use HeyGen to personalize avatar videos by swapping in a custom face?

Yes, you can use HeyGen to personalize avatar videos by chaining an avatar-generation workflow with the FaceswapNode. You generate the base avatar footage first, then swap in a custom face to create personalized messages, demos, or marketing assets.

Do I need an API key to automate face replacement in videos?

Yes, you need a HeyGen API key to authenticate face replacement requests. You must include the X-Api-Key header when submitting the target video and source image to the FaceswapNode workflow for automated processing.

How long does it take for a HeyGen face swap workflow to complete?

HeyGen face swap workflows require GPU processing time, so completion times vary based on the target video length. You should poll the workflows executions endpoint approximately every 10 seconds until the execution status is completed and the output video URL is available.

What are the best practices for a source image to ensure high-quality face replacement?

For high-quality face replacement, use a single, front-facing source image with good lighting. After the GPU processing completes, always validate the resulting output video URL before distributing your personalized clips or marketing assets.