how-tos

HeyGen Avatar 6 API text to avatar: presentatorvideo's vanuit een script, zonder audiobestand

Poyo.ai Team
9 min read
Share:

HeyGen Avatar 6 API text to avatar: een presentatorvideo vanuit een script

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"
  }
}
VeldVerplichtRegel
avatarJaEen van 1,248 looknamen
textJa (in plaats van audio_url)1–1,000 tekens
voiceNeeEen van 102 namen; standaard Warm Pro Narrator
promptNeeTot 1,200 tekens regie
aspect_ratioNee16:9 (standaard), 9:16, 1:1, 4:5, 5:4
resolutionNee1080p (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:

SleutelInhoud
modelsheygen-avatar-6, heygen-avatar-6-turbo (dezelfde namen werken op beide)
default_voiceWarm Pro Narrator
avatarsAlle 1,248 looknamen, in een platte lijst
avatars_by_personDezelfde looks, gegroepeerd onder 156 personen
voicesAlle 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 wiltZoek naar namen metVoorbeelden
Presentator recht in de cameraFrontAbigail Office Front, Bryan Suit Front
DriekwartaanzichtSideAbigail Office Side
Zittend, informeelSofa, Sitting, LoungeAnnie Sofa Sitting Front
Een rol of settingDoctor, Nurse, Yoga, Tech ExpertAnn 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 Hope en Hope (met een spatie aan het eind) twee verschillende stemmen zijn. Archer , Cassidy , Adam Stone , Spuds Oxley en Andrew Rizz eindigen 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 😊 of Brenda - 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 Expert met Andrew en Abigail Office Front met Jessica 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 text waarop elke actie moet vallen, zodat de cue ondubbelzinnig is.
  • Beschrijf eerst één rol of stemming ("Friendly product expert"), daarna de cues.
  • Laat prompt weg 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.

Plaatsingaspect_ratio
Website, YouTube, LMS-les16:9 (standaard)
Shorts, Reels, TikTok, stories9:16
Vierkante feedpost, kaart in de app1:1
Staande feedpost4:5
Liggende feedpost5: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):

ModelAvatar / stemScriptOutputKosten tegen huidige prijzenDoorlooptijd
heygen-avatar-6-turboAbigail Office Front / Jessica Anne Bogart27 woorden10.16 s110 credits ($0.55)Ongeveer 2.4 min
heygen-avatar-6Bryan Tech Expert / Andrew21 woorden6.88 s140 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.

Share: