faceswap

Swap a face from a source image into a target video via HeyGen API.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/hanzoai/video --skill faceswap-hanzoai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: faceswap
Source: https://github.com/hanzoai/video/tree/main/.agents/skills/faceswap
Command: npx skills add https://github.com/hanzoai/video --skill faceswap-hanzoai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Swap a face from a source image into a target video using GPU-accelerated AI processing to enable personalized or avatar-style video creation without manual editing.

Core Features & Use Cases

  • Face replacement in videos using a source image.
  • Works with HeyGen's /v1/workflows/executions endpoint to manage the faceswap workflow.
  • Use cases include creating personalized avatars by swapping in a recognizable face for video content.

Quick Start

Provide a source image URL and a target video URL to initiate a face swap and retrieve the resulting video URL.

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 from an image into a video using AI?

To swap a face into a video, provide a source image URL and a target video URL. GPU-accelerated AI processing replaces the target face and returns a final personalized video after polling for workflow completion.

Does the faceswap workflow require HeyGen API access?

Yes, the face replacement workflow requires HeyGen API access. It executes via the v1/workflows/executions endpoint using the FaceswapNode workflow type to manage processing and return the final video.

Can I create personalized avatar videos by replacing faces in existing media?

Yes, you can create personalized avatar videos by replacing faces in existing media. This skill uses a source image to swap faces into a target video, generating recognizable avatar-style content without manual editing.

What inputs do I need to start an AI face replacement process?

You need a source image URL containing the face to extract and a target video URL where the face will be inserted. These two URLs are submitted to initiate the GPU-accelerated AI processing workflow.

How does the face swap API return the final processed video?

The face swap API returns the final processed video by polling the HeyGen workflow execution for completion. Once the GPU-accelerated AI processing finishes, it outputs a URL to retrieve the swapped video.