![]()
De HeyGen Avatar 6 API kan een presentatorvideo maken van niets meer dan een script. In de publieke avatarmodus geef je een van de 1,248 stocklooks van HeyGen op, stuur je tot 1,000 tekens text, kies je een van 102 stemmen, en heygen-avatar-6 (of heygen-avatar-6-turbo) levert een lipsynchrone MP4 op. Geen foto, geen opname, geen text-to-speech-stap aan jouw kant. Deze walkthrough behandelt het kiezen van een look en een stem uit de catalogus, het regisseren van gebaren met prompt, het kiezen van een beeldformaat en wat een tekstrequest kost. Je kunt de looks ook bekijken op de HeyGen Avatar 6-modelpagina.
De text-to-avatar-request
Dit is de gedocumenteerde body voor de publieke avatarmodus met tekst:
{
"model": "heygen-avatar-6-turbo",
"input": {
"avatar": "Abigail Office Front",
"text": "Hello and welcome to this demonstration of HeyGen Avatar 6.",
"voice": "Warm Pro Narrator",
"prompt": "Speak with calm confidence and nod slightly at the end.",
"aspect_ratio": "16:9",
"resolution": "1080p"
}
}
| Veld | Verplicht | Regel |
|---|---|---|
avatar | Ja | Een van 1,248 looknamen |
text | Ja (in plaats van audio_url) | 1–1,000 tekens |
voice | Nee | Een van 102 namen; standaard Warm Pro Narrator |
prompt | Nee | Tot 1,200 tekens regie |
aspect_ratio | Nee | 16:9 (standaard), 9:16, 1:1, 4:5, 5:4 |
resolution | Nee | 1080p (standaard) of 2K |
De aanwezigheid van avatar is wat deze modus kiest. Stuur niet ook image_urls of video_url mee; gebruik per request de invoer van één modus. Dien in bij POST https://api.poyo.ai/api/generate/submit en poll /api/generate/status/{task_id} zoals in de HeyGen Avatar 6 API-gids.
Kies een avatarlook uit de catalogus
PoYo publiceert elke naam op de pagina Avatars and Voices en als JSON-catalogus. De catalogus heeft vijf sleutels:
| Sleutel | Inhoud |
|---|---|
models | heygen-avatar-6, heygen-avatar-6-turbo (dezelfde namen werken op beide) |
default_voice | Warm Pro Narrator |
avatars | Alle 1,248 looknamen, in een platte lijst |
avatars_by_person | Dezelfde looks, gegroepeerd onder 156 personen |
voices | Alle 102 stemnamen |
Elke persoon heeft één of meer looks, en elke look is een aparte avatar-waarde. Abigail heeft er vijf (Abigail (Upper Body), Abigail Office Front, Abigail Office Side, Abigail Sofa Front, Abigail Sofa Side); Annie heeft er 54; acht personen hebben één enkele look. De namen beschrijven setting, outfit en camerahoek, en dat is meestal genoeg om zonder preview te kiezen:
| Je wilt | Zoek naar namen met | Voorbeelden |
|---|---|---|
| Presentator recht in de camera | Front | Abigail Office Front, Bryan Suit Front |
| Driekwartaanzicht | Side | Abigail Office Side |
| Zittend, informeel | Sofa, Sitting, Lounge | Annie Sofa Sitting Front |
| Een rol of setting | Doctor, Nurse, Yoga, Tech Expert | Ann Doctor Standing, Adriana Nurse Front, Amelia Yoga Front, Bryan Tech Expert |
Ongeveer 480 namen bevatten Front en ongeveer 430 bevatten Side. Kies voor een reeks uitlegvideo's één persoon en blijf bij diens Front-looks, zodat de presentator in alle video's dezelfde blijft. Gebruik de bijbehorende Side-look voor tussenshots.
Namen matchen ongeacht hoofdletters en extra spaties, dus abigail office front selecteert Abigail Office Front. PoYo controleert avatar bij het indienen tegen de lijst, dus een typfout geeft direct een 400 in plaats van een mislukte taak. Valideer eerst in je eigen code:
import requests
catalog = requests.get(
"https://docs.poyo.ai/api-manual/video-series/heygen-avatar-6-catalog.json", timeout=30
).json()
def norm(name: str) -> str:
return " ".join(name.split()).lower()
AVATARS = {norm(a): a for a in catalog["avatars"]}
VOICES = set(catalog["voices"])
def build_request(model, avatar, text, voice=None, prompt=None, aspect_ratio="16:9", resolution="1080p"):
if norm(avatar) not in AVATARS:
raise ValueError(f"unknown avatar: {avatar!r}")
if not 1 <= len(text) <= 1000:
raise ValueError("text must be 1-1,000 characters")
if voice is not None and voice not in VOICES:
raise ValueError(f"unknown voice: {voice!r} (copy the exact name from the catalog)")
if prompt is not None and len(prompt) > 1200:
raise ValueError("prompt must be at most 1,200 characters")
body = {"avatar": AVATARS[norm(avatar)], "text": text,
"aspect_ratio": aspect_ratio, "resolution": resolution}
if voice:
body["voice"] = voice
if prompt:
body["prompt"] = prompt
return {"model": model, "input": body}
De stemcontrole gebruikt bewust exacte namen; de volgende sectie legt uit waarom.
Kies een stem
voice bepaalt wie text voorleest. Laat je het weg, dan krijg je Warm Pro Narrator. De 102 stemmen omvatten gewone namen (Andrew, Ivy, Jessica Anne Bogart), beschrijvende namen (Calm Chloe, Professor Dean, Radio Rick, Chill Brian) en enkele met een stijllabel in de naam.
Drie dingen zetten mensen op het verkeerde been:
- Spaties aan het eind kunnen ertoe doen. De docs wijzen erop dat
HopeenHope(met een spatie aan het eind) twee verschillende stemmen zijn.Archer,Cassidy,Adam Stone,Spuds OxleyenAndrew Rizzeindigen in de catalogus ook op een spatie. Kopieer namen uit de JSON in plaats van ze over te typen. - Sommige namen bevatten emoji of bestandsachtige achtervoegsels, zoals
Cute Chloe - Friendly 😊ofBrenda - UGC - 1.mp4. Die tekens horen bij de naam. Stuur de requestbody als UTF-8-JSON, dan komt de naam ongewijzigd door. - De stem is niet aan de avatar gekoppeld. Elk van de 102 stemmen kan voorlezen voor elk van de 1,248 looks. Kies een stem die past bij de persoon in beeld; in onze tests op de lanceringsdag combineerden we
Bryan Tech ExpertmetAndrewenAbigail Office FrontmetJessica Anne Bogart.
voice geldt alleen als je text stuurt. Stuur je in plaats daarvan audio_url, dan spreekt de avatar jouw opname uit en wordt voice niet gebruikt.
Regisseer gebaren met prompt
prompt accepteert tot 1,200 tekens regie voor gebaren, expressie en houding. Het technische rapport van HeyGen beschrijft de techniek: "Schrijf de actie naast de woorden. Avatar 6 voert die precies op het juiste moment uit." Het voorbeeld daarin: "Friendly pharmacist. On 'Hello', give a thumbs up. On 'the counter on the left', point to the side with your index finger."
Een patroon dat dat formaat volgt:
{
"model": "heygen-avatar-6",
"input": {
"avatar": "Bryan Tech Expert",
"text": "Hello! Today I will show you three settings that make your dashboard faster. First, open the menu on the left.",
"voice": "Andrew",
"prompt": "Friendly product expert. On 'Hello', wave once. On 'three settings', hold up three fingers. On 'the menu on the left', point to his left side. Keep a relaxed posture and smile between sentences.",
"aspect_ratio": "16:9",
"resolution": "1080p"
}
}
Tips die prompts bruikbaar houden:
- Citeer de exacte woorden uit
textwaarop elke actie moet vallen, zodat de cue ondubbelzinnig is. - Beschrijf eerst één rol of stemming ("Friendly product expert"), daarna de cues.
- Laat
promptweg als je geen specifieke cues hebt. De lanceringspagina van Avatar 6 van HeyGen zegt dat het model zelf "gebaren, emotie en expressie afstemt op je script".
Kies de beeldverhouding voor de plaatsing
aspect_ratio bestaat alleen in de publieke avatarmodus; foto- en referentievideomodus behouden de vorm van de invoer.
| Plaatsing | aspect_ratio |
|---|---|
| Website, YouTube, LMS-les | 16:9 (standaard) |
| Shorts, Reels, TikTok, stories | 9:16 |
| Vierkante feedpost, kaart in de app | 1:1 |
| Staande feedpost | 4:5 |
| Liggende feedpost | 5:4 |
resolution staat daar los van: 1080p of 2K in elke verhouding. 2K kost meer per seconde, dus render concepten in 1080p.
Hoe lang de video wordt en wat die kost
Met tekst duurt de video zo lang als de avatar nodig heeft om die voor te lezen, tot 1,000 tekens. Je betaalt voor de lengte van de afgewerkte video, naar boven afgerond op hele seconden. Credits worden bij het indienen gereserveerd en verrekend met de werkelijke seconden wanneer de taak klaar is.
Onze tests op de lanceringsdag op de productie-API, 19 november 2026 (16:9, 1080p):
| Model | Avatar / stem | Script | Output | Kosten tegen huidige prijzen | Doorlooptijd |
|---|---|---|---|---|---|
heygen-avatar-6-turbo | Abigail Office Front / Jessica Anne Bogart | 27 woorden | 10.16 s | 110 credits ($0.55) | Ongeveer 2.4 min |
heygen-avatar-6 | Bryan Tech Expert / Andrew | 21 woorden | 6.88 s | 140 credits ($0.70) | Ongeveer 2 min |
Dat komt in deze twee runs neer op ongeveer 2.7 en 3.1 woorden per seconde, handig voor een ruw budget maar geen garantie, omdat het tempo per stem en script verschilt. Tarieven per seconde: Turbo 10 credits ($0.05) in 1080p of 18 ($0.09) in 2K; Avatar 6 20 credits ($0.10) of 29 ($0.145). Zie Prijzen van de HeyGen Avatar 6 API voor meer.
Omdat teksttaken een reservering vasthouden terwijl ze lopen, kan het tegelijk afvuren van veel taken HTTP 200 met body-code 402 (insufficient_credits_error) opleveren. In onze test werd een derde request geweigerd met: "this request needs at least 252 credits, and 344 credits are already reserved by your unfinished HeyGen Avatar 6 text tasks." Zet teksttaken in een wachtrij, of houd een saldo aan dat de lopende reserveringen dekt. Gebruik Turbo zolang je itereert; de vergelijking Avatar 6 vs Turbo laat zien wanneer je overstapt.
Veelgestelde vragen
Kan de HeyGen Avatar 6 API tekst omzetten in een video met een pratende avatar?
Ja. Stuur in de publieke avatarmodus avatar, tot 1,000 tekens text en optioneel voice. Er is geen audiobestand nodig.
Waar staat de lijst met avatars en stemmen van de HeyGen Avatar 6 API?
Op de PoYo-docspagina Avatars and Voices, en als downloadbare JSON-catalogus met de sleutels avatars, avatars_by_person en voices.
Wat is de standaardstem in de HeyGen Avatar 6 API?
Warm Pro Narrator, die wordt gebruikt als voice ontbreekt.
Kan ik mijn eigen foto met tekst gebruiken in plaats van een stockavatar?
Nee. text werkt alleen in de publieke avatarmodus. Gebruik voor je eigen foto de fotomodus met image_urls en een audio_url; genereer de audio zo nodig eerst met een TTS-model.
Welke beeldverhoudingen ondersteunt text to avatar in HeyGen Avatar 6?
16:9, 9:16, 1:1, 4:5 en 5:4, in 1080p of 2K.
Hoe wordt een tekstrequest van de HeyGen Avatar 6 API gefactureerd?
Op de lengte van de afgewerkte video, naar boven afgerond op hele seconden, tegen het tarief per seconde van het model. Credits worden bij het indienen gereserveerd en verrekend wanneer de taak eindigt.