HeyGen Avatar 6 Turbo Reference Video API

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

HeyGen Avatar 6 Turbo 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.050/sec = $0.250

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

Continue with

Examples

Points at the map with its flipper on 'kalt und klar'.

What is the HeyGen Avatar 6 Turbo Reference Video API?

HeyGen Avatar 6 Turbo is HeyGen's talking-avatar video model, released on November 17, 2026. The HeyGen Avatar 6 Turbo 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 lower-latency Avatar 6 tier, at half the 1080p price of HeyGen Avatar 6.

Why choose the HeyGen Avatar 6 Turbo Reference Video API?

The HeyGen Avatar 6 Turbo Reference Video API makes cartoon characters talk in their own art style at Turbo prices.

  • Built for stylized charactersAvatar 6 Turbo 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 Turbo costs 10 credits ($0.05) per second at 1080p and 18 credits ($0.09) per second at 2K, based on the audio length rounded up.

What parameters does the HeyGen Avatar 6 Turbo 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 Turbo Reference Video API?

Send a 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 Turbo Reference Video API cost?

The HeyGen Avatar 6 Turbo Reference Video API costs 10 credits ($0.05) per second at 1080p and 18 credits ($0.09) per second at 2K.

UsageRateDetails
1080p10 credits ($0.05) / secondCharged at submission on the audio length rounded up; 5 seconds cost 50 credits.
2K18 credits ($0.09) / secondCharged at submission on the audio length rounded up; 5 seconds cost 90 credits.

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

This API fits mascots, animated series, kids' lessons and in-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 Turbo

  • 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:

“Write the action next to the words. Avatar 6 performs it right on cue, in the person's own style.”

— HeyGen Research, HeyGen Avatar 6 Technical Report,

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

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

HeyGen Avatar 6 Turbo Reference Video API FAQ

What is the HeyGen Avatar 6 Turbo Reference Video API?

HeyGen Avatar 6 Turbo is HeyGen's talking-avatar model, released on November 17, 2026. The HeyGen Avatar 6 Turbo 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-turbo/ref-video-to-video, or try it in the Playground above.

Which characters does the HeyGen Avatar 6 Turbo 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 Turbo 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 Turbo Reference Video API cost for character videos?

Avatar 6 Turbo costs 10 credits ($0.05) per second at 1080p and 18 credits ($0.09) per second at 2K, based on the audio length rounded up. A 5-second line at 1080p costs 50 credits ($0.25).

Should I add image_urls to the HeyGen Avatar 6 Turbo 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 Turbo Reference Video API with a character clip?

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