skills.rest
shige1014-dev
shige1014-devCOMMUNITY
Explore all skills by this author →
GitHub

faceswap

Swap a face from a source image into a target video via HeyGen's FaceswapNode workflow.

1|Updated Apr 11, 2026
Search Tags:#api#video#video-editing#avatar#heygen#faceswap#face-replacement
One-click install
npx skills add https://github.com/shige1014-dev/backup-OpenMontage --skill faceswap-shige1014-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: faceswap
Source: https://github.com/shige1014-dev/backup-OpenMontage/tree/main/.agents/skills/faceswap
Command: npx skills add https://github.com/shige1014-dev/backup-OpenMontage --skill faceswap-shige1014-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables swapping a face from a source image into a target video using HeyGen's GPU-accelerated workflow, removing manual compositing and complex masking steps.

Core Features & Use Cases

  • API-driven face swap: Submit a source image and target video to HeyGen's FaceswapNode workflow and receive a processed video URL.
  • Polling and status handling: Guidance for execution submission, polling for completion, and basic error outcomes.
  • Use Case: Personalize marketing clips, replace faces in avatar videos, or generate demo edits that require a custom face in motion footage.

Quick Start

Use the faceswap skill to swap the face from https://example.com/face.jpg into the video at https://example.com/video.mp4.

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 in a video using an API?▼

To swap a face in a video via API, submit a source image and target video to HeyGen's FaceswapNode workflow, then poll the execution endpoint until the status changes to completed to receive your processed video URL.

Can I replace faces in avatar videos for marketing clips?▼

Yes, you can replace faces in avatar videos for marketing clips. The API-driven face swap workflow personalizes avatar videos by applying a custom face from a source image directly onto motion footage.

Do I need a HeyGen API key to perform face replacement?▼

Yes, you need a HeyGen API key for face replacement. The workflow requires HEYGEN_API_KEY authentication to access the /v1/workflows/executions endpoint and process your video face swap request.

What is the best way to automate face-swapped video generation?▼

The best way to automate face-swapped video generation is using HeyGen's GPU-accelerated workflow. It removes manual compositing by handling execution submission and polling automatically until the video processing completes.

How does polling work for video editing face swap tasks?▼

Polling for video editing face swap tasks works by continuously checking the HeyGen workflow execution status. After submitting your source image and target video, the API is polled until the execution reports a completed status.

Related Skills

Explore More Design & Creative Skills→
calesthiocalesthio
46.2k

faceswap

Swap faces in videos via HeyGen FaceswapNode workflows.

Community
Intermediate
video-production-buddyvideo-production-buddy
602

faceswap

Automate face swapping in videos via HeyGen's FaceswapNode API.

Official
Intermediate
GroundMountCompanyGroundMountCompany

ai-talking-head

Generate AI talking head videos with lip-sync using multiple model backends.

Community
Advanced
sayasaya8039sayasaya8039
2

video-editing

Automate cutting, structuring, and augmenting raw video footage with FFmpeg and Remotion.

Community
Intermediate