heygen/avatar-iv

Create realistic talking avatar videos from text with HeyGen's Avatar IV engine

Capabilities

1:14:33:416:99:162:33:2

Community model (estimated from hardware time)

Name	Type	Description	Default	Constraints
`avatar_id`*	string	Unique identifier of the avatar. Get available avatar IDs from the HeyGen List All Avatars API.	`—`	—
`input_text`*	string	Text that the avatar will speak. Must be less than 5000 characters.	`—`	—
`voice_id`*	string	Unique identifier of the voice. Get available voice IDs from the HeyGen List All Voices API.	`—`	—
`avatar_style`	string	Visual style of the avatar.	`"normal"`	normalcloseUpcircle
`caption`	boolean	Whether to enable captions in the video.	`false`	—
`height`	integer	Height of the output video in pixels.	`1080`	min: 100, max: 2160
`title`	string	Title of the video.	`""`	—
`voice_emotion`	string	Adds emotion to voice, if supported by the selected voice. Set to 'none' for no emotion.	`"none"`	noneExcitedFriendlySeriousSoothingBroadcaster
`voice_speed`	number	Voice speed. Value ranges from 0.5 to 1.5.	`1`	min: 0.5, max: 1.5
`width`	integer	Width of the output video in pixels.	`1920`	min: 100, max: 3840

avatar_idrequiredstring

Unique identifier of the avatar. Get available avatar IDs from the HeyGen List All Avatars API.

input_textrequiredstring

Text that the avatar will speak. Must be less than 5000 characters.

voice_idrequiredstring

Unique identifier of the voice. Get available voice IDs from the HeyGen List All Voices API.

avatar_stylestring

Visual style of the avatar.

Default: "normal"

normalcloseUpcircle

captionboolean

Whether to enable captions in the video.

Default: false

heightinteger

Height of the output video in pixels.

Default: 1080min: 100, max: 2160

titlestring

Title of the video.

Default: ""

voice_emotionstring

Adds emotion to voice, if supported by the selected voice. Set to 'none' for no emotion.

Default: "none"

noneExcitedFriendlySeriousSoothingBroadcaster

voice_speednumber

Voice speed. Value ranges from 0.5 to 1.5.

Default: 1min: 0.5, max: 1.5

widthinteger

Width of the output video in pixels.

Default: 1920min: 100, max: 3840

Version: 47140d7dd37bUpdated: 7/25/2026508 runs