HeyGen Avatar 6 Reference Video API

heygen/avatar-6/ref-video-to-video
1080p or 2K · 2–60 sec audio

HeyGen Avatar 6 Reference Video API gives animated and illustrated characters a voice: send a short video of the character and 2–60 seconds of speech, and get a lip-synced talking video in 1080p or 2K that keeps the character's art style and the clip's framing.

Input

Drag and drop files, paste from clipboard, or provide a URL. Required. Animated or illustrated character clip, 2 seconds or longer, up to 50 MB.

1/1 files added

Drag and drop files, paste from clipboard, or provide a URL. Optional. One still image of the same character.

1/1 files added

Drag and drop files, paste from clipboard, or provide a URL. Required. 2–60 seconds of speech, up to 15 MB.

1/1 files added

OutputExample
Charge: 5 sec × $0.100/sec = $0.500

Charged at submission on the audio length rounded up to whole seconds.

Continue with

Examples

Cheerful and bouncy; on 'ocho canciones' it spreads its arms wide.

What is the HeyGen Avatar 6 Reference Video API?

HeyGen Avatar 6 is HeyGen's talking-avatar video model, released on November 17, 2026. The HeyGen Avatar 6 Reference Video API is built for mascots, cartoon hosts and illustrated characters: a clip of at least 2 seconds shows how the character looks and moves, an optional still of the same character adds detail, and your audio drives the performance. This is HeyGen's Avatar 6 Quality tier with native 2K rendering.

Why choose the HeyGen Avatar 6 Reference Video API?

The HeyGen Avatar 6 Reference Video API gives cartoon and illustrated characters a voice while keeping their art style and framing.

  • Built for stylized charactersAvatar 6 animates claymation, watercolor, low-poly, paper-craft and other illustrated characters.

  • Art style stays intactThe output keeps the look of the reference clip, from clay fingerprints to brush texture.

  • Optional reference stillAdd one image of the same character to give the model a clear view of the face.

  • Gestures on cueUse up to 1,200 characters of prompt to place a wave, a point or a wink on a chosen word.

  • 1080p or 2KThe video keeps the reference clip's aspect ratio at the resolution you pick.

  • Per-second pricingAvatar 6 costs 20 credits ($0.10) per second at 1080p and 29 credits ($0.145) per second at 2K, based on the audio length rounded up.

What parameters does the HeyGen Avatar 6 Reference Video API accept?

This API needs video_url and audio_url; image_urls, prompt and resolution are optional.

ParameterRequirementDescription
video_urlRequired

Public HTTP(S) URL of a video of an animated or illustrated character, at least 2 seconds and up to 50 MB.

Default—
image_urlsOptional

One public HTTP(S) URL of a still image of the same character.

Default—
audio_urlRequired

Public HTTP(S) URL of the speech audio, 2–60 seconds and up to 15 MB.

Default—
promptOptional

Direction for gestures, expression and posture, up to 1,200 characters.

Default—
resolutionOptional

1080p or 2K.

Default1080p

How do you use the HeyGen Avatar 6 Reference Video API?

Send a short character clip and 2–60 seconds of speech to the API, then poll for the video URL.

  1. Prepare a character clipExport a clip of the cartoon or illustrated character, 2 seconds or longer and up to 50 MB.

  2. Add a still if you have oneA clean image of the same character helps keep the face consistent.

  3. Record the voiceUpload 2–60 seconds of speech; the video runs as long as the audio.

  4. Submit and collectSend the request with the model ID, then poll the status endpoint or use callback_url.

How much does the HeyGen Avatar 6 Reference Video API cost?

The HeyGen Avatar 6 Reference Video API costs 20 credits ($0.10) per second at 1080p and 29 credits ($0.145) per second at 2K.

UsageRateDetails
1080p20 credits ($0.10) / secondCharged at submission on the audio length rounded up; 5 seconds cost 100 credits.
2K29 credits ($0.145) / secondCharged at submission on the audio length rounded up; 5 seconds cost 145 credits.

What is the HeyGen Avatar 6 Reference Video API best for?

This API fits brand mascots, animated shorts, children's lessons and game characters.

  • Brand mascotsLet a mascot greet visitors, announce news or explain a feature in its own style.

  • Animated series and shortsAdd dialogue to characters from an existing clip for episodes and teasers.

  • Children's learning contentGive a friendly character the narration for lessons and reading time.

  • Game and app charactersProduce talking intros for in-game or in-app characters.

Pro tips for HeyGen Avatar 6

  • Pick a clip where the character faces the camera and the mouth area is visible.
  • Keep the clip steady with simple motion; the audio supplies the performance.
  • Add the character still in image_urls when the clip shows the face small or at an angle.
  • Choose 2K for detailed art such as clay, paper or watercolor textures.

Notes

  • This mode is designed for animated and illustrated characters.
  • The reference video must be at least 2 seconds long and up to 50 MB; audio is 2–60 seconds and up to 15 MB.
  • The video keeps the reference clip's aspect ratio, and its length follows the audio.

Sources

Model details on this page come from HeyGen's own publications:

“Avatar 6 picks up your voice, expressions, and motion.”

— HeyGen, HeyGen Avatar 6: AI Avatar Model That Looks Like You

“Avatar 6 reproduces how a person looks, speaks, and moves, up to 2K”

— HeyGen Research, HeyGen Avatar 6 Technical Report,

HeyGen Avatar 6 Reference Video API FAQ

What is the HeyGen Avatar 6 Reference Video API?

HeyGen Avatar 6 is HeyGen's talking-avatar model, released on November 17, 2026. The HeyGen Avatar 6 Reference Video API turns a short clip of a cartoon or illustrated character and 2–60 seconds of speech into a lip-synced talking video in 1080p or 2K, keeping the character's art style. An optional still of the same character and a prompt of up to 1,200 characters refine the result. Call it with the model ID heygen/avatar-6/ref-video-to-video, or try it in the Playground above.

Which characters does the HeyGen Avatar 6 Reference Video API support in this mode?

Animated and illustrated characters: claymation, 2D cartoons, watercolor, low-poly 3D, paper craft and similar styles.

How long should the reference video be for the HeyGen Avatar 6 Reference Video API?

At least 2 seconds, up to 50 MB. The output keeps the clip's aspect ratio.

How much does the HeyGen Avatar 6 Reference Video API cost for character videos?

Avatar 6 costs 20 credits ($0.10) per second at 1080p and 29 credits ($0.145) per second at 2K, based on the audio length rounded up. A 5-second line at 1080p costs 100 credits ($0.50).

Should I add image_urls to the HeyGen Avatar 6 Reference Video API request?

Add one still of the same character when the clip shows the face small or at an angle; it gives the model a clear reference.

How do I call the HeyGen Avatar 6 Reference Video API with a character clip?

POST to https://api.vidgo.ai/api/generate/submit with model heygen/avatar-6/ref-video-to-video, video_url and audio_url, then poll /api/generate/status/{task_id} or set callback_url.