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.