HeyGen Avatar 6 API
HeyGen Avatar 6 — turns one photo and speech audio into a talking video with natural lip-sync and gestures that follow the script, at 1080p or 2K, in Standard and Turbo versions.
heygen/avatar-6 animates a photo or illustration of one person with your audio; the video runs as long as the recording and keeps the image's aspect ratio. A motion prompt directs gestures, expression and posture, and heygen/avatar-6/turbo renders the same inputs faster.
Overview
About the HeyGen Avatar 6 API
What HeyGen Avatar 6 does, how it fits in the HeyGen model lineup, and why teams reach for it.
HeyGen Avatar 6 is a video generation model from HeyGen, available through the WaveSpeedAI REST API. HeyGen Avatar 6 — turns one photo and speech audio into a talking video with natural lip-sync and gestures that follow the script, at 1080p or 2K, in Standard and Turbo versions.
heygen/avatar-6 animates a photo or illustration of one person with your audio; the video runs as long as the recording and keeps the image's aspect ratio. A motion prompt directs gestures, expression and posture, and heygen/avatar-6/turbo renders the same inputs faster.
The HeyGen Avatar 6 family on WaveSpeedAI ships 2 REST endpoints covering Digital-Human workflow. Each variant carries its own pricing, parameter knobs, and example outputs — pick the one that matches your input modality and production constraints, or call several from the same API key to compose multi-step pipelines.
Run HeyGen Avatar 6 through the same API key, billing account, and rate-limit envelope you use for the other 1,000+ AI models on WaveSpeedAI. No separate vendor setup, no per-provider SDKs, no per-vendor rate-limit envelopes — one integration covers everything from text-to-image and text-to-video through audio synthesis, 3D generation, upscaling, and editing.
Specs
HeyGen Avatar 6 API capabilities and release status
The model-specific details developers search for before choosing an API: availability, expected output length, reference support, and the current live fallback.
Inputs
One photo + speech audio
An optional prompt directs gestures, expression and posture.
Resolution
1080p / 2K
1080p is the default; the video keeps the image's aspect ratio.
Length
Follows the audio
Up to 10 minutes per request.
Versions
Standard / Turbo
Turbo renders the same inputs faster.
Endpoints
All HeyGen Avatar 6 API endpoints
2 HeyGen Avatar 6 endpoints available now on WaveSpeedAI — pick the variant that matches your workflow.
/filters:quality(82)/media/images/46f9c55a-6500-4524-928c-496e177258fb.webp)
Avatar 6 Turbo
HeyGen Avatar 6 Turbo turns a portrait image and speech audio into talking-avatar videos with natural lip sync and prompt-guided gestures, making it suitable for digital humans, virtual presenters, marketing content, training, and rapid avatar video workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/7d7bc83a-2d9b-47d1-84df-46f15a81770d.webp)
Avatar 6
HeyGen Avatar 6 turns a portrait image and speech audio into a talking-avatar video with natural lip sync and prompt-guided, script-aware gestures, making it suitable for digital humans, virtual presenters, marketing content, training, and personalized video workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Examples
See HeyGen Avatar 6 in action
Real outputs generated by the HeyGen Avatar 6 API. Hover any video to preview, click to open the full-size viewer.
How to
How to use the HeyGen Avatar 6 API
Four steps from signup to a finished generation. Full Python, Node.js, and cURL examples are in the API section below.
- 01
Get an API key
Sign up for a WaveSpeedAI account and copy your API key from the dashboard. New accounts come with free starter credits — enough to run the playground a few dozen times before billing kicks in.
- 02
Submit a prediction
POST your input as JSON to https://api.wavespeed.ai/api/v3/heygen/avatar-6. The endpoint returns a prediction id immediately — generations are async so you don't hold an open connection during inference.
- 03
Poll for completion
GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. Return outputs on completed; stop with an error on failed, cancelled, timeout, or deleted; continue polling for every other status.
- 04
Read the output URL
Once status is "completed", read the URL from data.outputs[0]. The URL points to your generated media on the WaveSpeedAI CDN — image, video, audio, or 3D file depending on the HeyGen Avatar 6 variant you called.
Use cases
What you can build with HeyGen Avatar 6
Common workflows developers and creators use the HeyGen Avatar 6 API for.
Presenter videos from one photo
heygen/avatar-6 needs only a clear photo or illustration of a face and a voice recording to produce a speaking presenter for announcements, explainers and training.
Gestures on cue
The avatar moves with what it says, and the prompt field directs gestures, expression and posture, for example pointing to one side or counting on fingers at a given line.
Long narration in one request
The video runs as long as the audio, up to 10 minutes per request, so a full lesson, walkthrough or podcast segment comes back as one clip.
Turbo for volume
heygen/avatar-6/turbo takes the same image, audio and prompt and renders faster, for drafts, personalized messages and high-volume work.
1080p or 2K output
Both versions render at 1080p or 2K and keep the aspect ratio of your image, so a portrait photo gives a vertical video and a landscape photo a horizontal one.
Tips
Tips for prompting HeyGen Avatar 6
Practical advice for getting better outputs from HeyGen Avatar 6 — drawn from the patterns that work across video models in production pipelines.
- 01
Be specific about camera moves
Mention concrete cinematography vocabulary — orbit, dolly-in, push-in, pan-left, crane shot, handheld follow. Generic prompts produce static or arbitrary camera choices; named camera moves map directly to motion intent in the model's training data and dramatically improve shot quality.
- 02
Anchor character identity with reference images
If your prompt depends on a specific person, character, or product, upload a reference image alongside the prompt. Without a reference, identity drifts across frames and across shots — the same character ends up looking like a slightly different person each generation.
- 03
Describe lighting and time of day
Lighting cues like 'golden hour, soft warm directional light' or 'overcast diffused light, slate-grey sky' improve quality and consistency far more than vague quality modifiers. Lighting is one of the strongest priors the model conditions on.
- 04
Use negative prompts to suppress common failure modes
Useful negatives for video: 'frame flicker, motion blur, watermark, text artifacts, distorted hands, low resolution, jpeg compression'. Negative prompts cost nothing and noticeably reduce the rate of generations you'd otherwise re-roll.
- 05
Pick the shortest duration that captures your beat
Most prompts work best at 5-8 seconds. Longer clips amplify temporal inconsistencies (subject morphing, environment drift). If you need a 20-second sequence, generate three 6-8 second clips and edit them together — quality stays higher than one long generation.
- 06
Match aspect ratio to platform up front
9:16 for TikTok / Reels / Shorts, 16:9 for landscape feeds and YouTube, 1:1 for post grids. Models train slightly differently per aspect ratio — cropping a 16:9 to 9:16 after the fact loses both fidelity and the composition the model intended.
Pricing
HeyGen Avatar 6 API pricing
Pricing is per-output. The final charge scales with the parameters you set in each variant's playground (resolution, duration, output count, references).
| Endpoint | Type | Starting price |
|---|---|---|
| heygen/ | digital-human | $0.06 |
| heygen/ | digital-human | $0.12 |
API
Call the HeyGen Avatar 6 API
Sign up for an API key at wavespeed.ai/accesskey, then submit a prediction via REST. The playground generates ready-to-paste samples for any combination of inputs.
POSThttps://api.wavespeed.ai/api/v3/heygen/avatar-6
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/heygen/avatar-6" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
"audio": "https://interactive-examples.mdn.mozilla.net/media/cc0-audio/t-rex-roar.mp3",
"resolution": "1080p"
}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
*) sleep 2 ;;
esac
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/heygen/avatar-6";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
"audio": "https://interactive-examples.mdn.mozilla.net/media/cc0-audio/t-rex-roar.mp3",
"resolution": "1080p"
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
"audio": "https://interactive-examples.mdn.mozilla.net/media/cc0-audio/t-rex-roar.mp3",
"resolution": "1080p"
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/heygen/avatar-6", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)Compare
HeyGen Avatar 6 vs alternatives
When to pick HeyGen Avatar 6 over similar models on WaveSpeedAI.
HeyGen Avatar 6 vs HeyGen Avatar IV
HeyGen Avatar IV also animates a portrait with your audio, with expressiveness, background and aspect-ratio controls up to 1080p. Avatar 6 is HeyGen's newer model, with gestures that follow the script and 2K output.
HeyGen Avatar 6 vs InfiniteTalk
InfiniteTalk turns a photo and audio into talking or singing video at 480p or 720p, with multi-character and video-to-video variants. Avatar 6 is the pick for 1080p or 2K presenter video.
HeyGen Avatar 6 vs LongCat Avatar 1.6
LongCat Avatar 1.6 produces calm, natural talking video at 480p or 720p for clips up to about a minute. Avatar 6 renders at 1080p or 2K and handles narration up to 10 minutes.
FAQ
HeyGen Avatar 6 API — Frequently asked questions
Pricing, license, integration — common questions about running HeyGen Avatar 6 on WaveSpeedAI.
What is the HeyGen Avatar 6 API?
HeyGen Avatar 6 is a HeyGen video generation model exposed as a REST API on WaveSpeedAI. HeyGen Avatar 6 — turns one photo and speech audio into a talking video with natural lip-sync and gestures that follow the script, at 1080p or 2K, in Standard and Turbo versions. You can call it programmatically or try it from the playground linked above.
How do I call the HeyGen Avatar 6 API?
Sign up for a WaveSpeedAI account, copy your API key from /accesskey, then POST to https://api.wavespeed.ai/api/v3/heygen/avatar-6 with your input as JSON. The endpoint returns a prediction id. Poll the result endpoint starting around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. Production-oriented Python / Node.js / cURL examples are above.
How much does the HeyGen Avatar 6 API cost?
HeyGen Avatar 6 starts at $0.06. The exact cost scales with the parameters you set (resolution, duration, output count, references). The live cost preview next to the Generate button in the playground shows the exact price for your current input.
Which HeyGen Avatar 6 variants are available?
WaveSpeedAI hosts 2 live HeyGen Avatar 6 endpoints: heygen/avatar-6/turbo, heygen/avatar-6. Each variant has its own playground page and pricing.
Can I use HeyGen Avatar 6 outputs commercially?
Commercial usage rights follow the HeyGen model license. Most HeyGen models permit commercial output use; see each model's playground page for the specific license summary, and WaveSpeedAI's Terms of Service for platform-level conditions.
Why use HeyGen Avatar 6 on WaveSpeedAI instead of going direct?
One API key + one billing account across HeyGen Avatar 6 AND 1,000+ other AI models from other providers. No per-vendor SDK setup, no separate rate-limit envelopes, no rewrite-per-vendor integration code. Pricing is typically at parity with or below HeyGen's direct API.
Provider
About HeyGen
The team behind HeyGen Avatar 6 and the broader HeyGen model lineup on WaveSpeedAI.
HeyGen is an AI video company whose avatar models turn a photo or a recording of a person into a speaking presenter, used for marketing, training and personalized video. Its Avatar 6 model adds gestures that follow the script and motion prompts for gesture and expression. On WaveSpeedAI the HeyGen models are available as REST endpoints with one API key and pay-as-you-go pricing.
Start building with HeyGen Avatar 6 on WaveSpeedAI
Free starter credits on signup. One API key across 1,000+ AI models from HeyGen and every other provider.