Create Video with Avatar IV
Produce dynamic avatar videos via Create Avatar IV Video
This guide walks you through generating avatar videos from a single photo with AI-powered motion, expressions, and voice.
1. Upload Photo
Before generating a video, upload your photo using the Upload Asset API. This will return an image_key, which is required for the Avatar IV video.
2. Prepare Script and Voice
Your video requires:
- Script - text that the avatar will speak.
- Voice - you must provide a
voice_id, obtained from the List All Voices (V2) API.
Additionally, you can provide a custom audio recording using:
audio_url- URL of a custom audio file.audio_asset_id- HeyGen asset ID of an audio file.
The
voice_idis a required parameter.
Customize Motion
Avatar IV Video also supports custom motion prompts, allowing you to guide the avatar’s gestures and expressions. Use descriptive prompts in the custom_motion_prompt field. Set enhance_custom_motion_prompt to true to let AI refine the motion.
Motion results depend on the script and prompt; the API does not require predefined gestures.
3. Generate Video
Make a POST request to the Create Avatar IV Video API with the required parameters: image_key, video_title, script, and voice_id.
For full request and response details, see detailed API reference: Create Avatar IV Video.
Updated about 23 hours ago