HeyGen API - Legacy Documentation
The v1 and v2 endpoints are legacy. All new development is on v3. For the latest documentation, visit developers.heygen.com.
The v1 and v2 endpoints will remain fully supported until October 1, 2026. HeyGen's engineering roadmap and all new feature development are focused exclusively on v3. We strongly encourage all users to migrate to v3 to take advantage of ongoing improvements, enhanced performance, and priority support.
What's different in v3?
The primary distinction between the legacy endpoints and v3 lies in the Studio API and Template API — both available in v2 but not yet supported in v3. Outside of these two areas, v3 provides full coverage of the HeyGen API and is the unified platform for all new development.
| Feature | v2 (Legacy) | v3 (Current) |
|---|---|---|
| Avatar Video Generation | ✅ | ✅ |
| Video Agent | ✅ | ✅ |
| Video Agent—styles, references, and interactive chat | ❌ | ✅ |
| Video Translate | ✅ | ✅ |
| Agentic CLI, MCP, Skills | ❌ | ✅ |
| Voice Design | ❌ | ✅ |
| Lipsyncs | ❌ | ✅ |
| Studio API | ✅ | 🚧 Not yet supported |
| Template API | ✅ | 🚧 Not yet supported |
| New features & improvements | ❌ | ✅ |
Updated 1 day ago