heygen-best-practices

When to use

How to use

Foundation

• rules/authentication.md - API key setup, X-Api-Key header, and authentication patterns
• rules/quota.md - Credit system, usage limits, and checking remaining quota
• rules/video-status.md - Polling patterns, status types, and retrieving download URLs
• rules/assets.md - Uploading images, videos, and audio for use in video generation

Core Video Creation

• rules/avatars.md - Listing avatars, avatar styles, and avatar_id selection
• rules/voices.md - Listing voices, locales, speed/pitch configuration
• rules/scripts.md - Writing scripts, pauses/breaks, pacing, and structure templates
• rules/video-generation.md - POST /v2/video/generate workflow and multi-scene videos
• rules/video-agent.md - One-shot prompt video generation with Video Agent API
• rules/dimensions.md - Resolution options (720p/1080p) and aspect ratios

Video Customization

• rules/backgrounds.md - Solid colors, images, and video backgrounds
• rules/text-overlays.md - Adding text with fonts and positioning
• rules/captions.md - Auto-generated captions and subtitle options

Advanced Features

• rules/templates.md - Template listing and variable replacement
• rules/video-translation.md - Translating videos, quality/fast modes, and dubbing
• rules/streaming-avatars.md - Real-time interactive avatar sessions
• rules/photo-avatars.md - Creating avatars from photos (talking photos)
• rules/webhooks.md - Registering webhook endpoints and event types

Integration

• rules/remotion-integration.md - Using HeyGen avatar videos in Remotion compositions