HeyGen: Avatar IV
Avatar IV animerar ett foto till en läppsynkroniserad talvideo med ansiktsuttryck och gesttiming styrda av rösten. HeyGen dokumenterar arbetsflöden med manus eller inspelat ljud och rörelsekontroller för Photo Avatar för verklighetstrogna eller stiliserade presentatörer.
Om modellen
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
Avatar IV är HeyGens avatarmotor för att omvandla en stillbild till en uttrycksfull talvideo. Dess diffusionsinspirerade utformning från ljud till uttryck använder röstton, rytm och känsla för att styra ansiktsrörelse, huvudlutningar, pauser och mikrouttryck. Syftet är en presentatör eller karaktär som framför talat innehåll med läppsynkronisering och gester, snarare än en allmän scengenerator som skapar en hel miljö och ett ljudspår från en filmisk prompt.
Tillverkaren beskriver stöd för verklighetstrogna och stiliserade karaktärer, inklusive vinklade bilder eller profilbilder, ansikten i animestil och husdjur. Fotobaserade karaktärer fungerar bäst när ögon, mun och ansiktsstruktur är lätta att identifiera. HeyGen rekommenderar en tydlig, välbelyst bild med naturlig hållning och synliga händer när gester är viktiga. Ett mycket litet ansikte, dolda läppar, kraftiga masker, en framträdande näbb eller starkt överdrivna proportioner kan försvaga ansiktsrörelse och läppsynkronisering. Håll källans bildutsnitt lämpat för avsett framförande.
Producenten erbjuder två vägar för talindata. Ett skrivet manus paras med en vald röst; ett förinspelat ljudspår tillhandahåller rösten och timingen direkt. Använd vägen för inspelat ljud när framförandet redan är fastställt och manusvägen när talet behöver syntetiseras. Indata är alternativ i det dokumenterade gränssnittet. Förbered slutlig ordalydelse, namn och uttal före animation och spara ljud eller manus tillsammans med returnerad video så att det talade resultatet kan kontrolleras.
HeyGens Avatar IV-modellprofil omfattar studioavatarer, Digital Twins, Photo Avatars, direkta bilder och promptskapade motiv. En återanvändbar Photo Avatar ger ett stabilt motiv för senare videor, medan ett arbetsflöde med direkt bild börjar från den angivna bilden. Producentens Photo Avatar-profil erbjuder rörelseinstruktioner i fri text och uttrycksfullhetsvalen high, medium eller low, med low som standard. Behåll valt avatarutseende och motor när en serie skapas så att en ändrad källbild eller renderingsmodell inte blir en obemärkt ändring av presentatören.
Beskriv en synlig kroppshandling och dess känslomässiga kvalitet för rörelseregi. ”Nickar varsamt med ett varmt leende” ger en gest och ett uttryck; en kort hälsning kan använda en vänlig vinkning. Tillverkaren rekommenderar en huvudgest, valfritt tillsammans med ett ansiktsuttryck, och högst två korta satser för en sekvens. Avatar IV hanterar tempot utifrån framförandet, så Studio-guiden kräver inget gestschema sekund för sekund. Specifik, kortfattad ordalydelse är lättare att granska än flera konkurrerande handlingar i en prompt.
Producentens ljud-till-video-profil renderar upp till trettio minuters angivet ljud per begäran och uppladdade MP3- eller WAV-resurser har en gräns på 32 MB. Dela materialet vid sammanhängande talgränser för en längre lektion eller inspelning och behåll originalordningen. Slutvideons talade timing ska följa valt ljud snarare än en orelaterad uppskattning av klipplängd.
De dokumenterade utdatainställningarna från producenten omfattar 720p eller 1080p och formerna 16:9, 9:16, 4:5, 5:4 eller 1:1, med ett automatiskt alternativ som följer källans proportioner. Cover-anpassning kan beskära motivet; contain passar in hela motivet och kan lämna omgivande bakgrund synlig. Arbetsflödet för ljud-till-video returnerar MP4 som standard. För videoavatarer kräver transparenta WebM-utdata stöd för friläggning, och producenten tillämpar bakgrundsborttagning för dessa utdata i stället för att kombinera dem med en ny bakgrund. Granska faktiskt bildutsnitt och fil innan presentatören placeras i en större komposition.
En utbildningsintroduktion kan använda en tydlig presentatörsbild, en kortfattad förklaring och en återhållsam gest vid nyckelinstruktionen. En produktförklaring kan behålla samma avatarutseende medan talmanuset ändras för olika funktioner. Producenten dokumenterar också valfria undertextfiler och inbrända undertexter; granska ordalydelse och timing tillsammans med talet. Renderingen är asynkron i tillverkargränssnittet, så ett skapandesvar och den färdiga videon är olika leveranser. Spara den färdiga inspelningen och dess slutförandestatus med uppgiftens resultat.
Avatar IV hålls separat från Avatar V:s referensstyrda rörelse och dess separata Studio-förinställningskontroller. Den skiljer sig också från HeyGen Videos generella scengenerering och från ett interaktivt live-avatarsamtal. Granska renderad munrörelse, synliga händer, ansiktsuttryck, pauser och talad ordalydelse mot källmaterial och avsedd ton. Bild, pose, ljussättning och rörelseinstruktioner påverkar resultatet; en fotobaserad animation ska kontrolleras som ett genererat framförande, med valda indata sparade för senare revideringar.
Ailoot Ultra · Videor POST /v1/videos heygen/avatar-iv
heygen/avatar-ivStart
Avatar IV animerar ett foto till en läppsynkroniserad talvideo med ansiktsuttryck och gesttiming styrda av rösten. HeyGen dokumenterar arbetsflöden med manus eller inspelat ljud och rörelsekontroller för Photo Avatar för verklighetstrogna eller stiliserade presentatörer.
- Godkända indata
- Text · Bilder · Ljud · Video
- Resultat
- Video
Tillgängligt i Ailoot · indata & metoder
Ailoot Ultra · Videor POST /v1/videos
- Indatatyper
text,image,audio,video- Utdatatyper
video
| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser heygen/avatar-iv | Standard— |
Fältinput_references | Typarray | KravObligatoriskt | Värden & gränser Minsta antal objekt: 2 Maximalt antal objekt: 2 | Standard— |
Fältprompt | Typstring | KravValfritt | Värden & gränser | Standard— |
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, input_references |
Parametermaterial_types | Avtaltext, image, audio, video |
Parametermaterial_conditions | AvtalAnvänd faktiska innehållslänkar till färdiga medietillgångar som du äger, med deras returnerade signaturer: en videokälla för BFL eller en bildkälla och en ljudkälla för avatar. Källans belägg för ägare, typ och byte krävs., Ange exakt en PNG/JPEG-bild och en WAV/MP3-ljudtillgång. Ljudet är högst 32000000 byte, med en längd större än 0 och högst 1800 sekunder. |
Livscykel: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · faktiskt returnerat id eller polling_url
GET /v1/videos/{request_id}/content
Priser
Så beräknas slutavgiften
De visade priserna används för att uppskatta kostnaden före genereringen. Den slutliga debiteringen beräknas utifrån den kostnad som registrerats för den ursprungliga genereringen. Uppmätt längd på resultatet och uppskattade mängder utgör inte den slutliga debiterbara mängden.
Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.
- Snabbt läge
- Ej angivet När snabbt läge är valt
- Flex-läge
- Ej angivet När läget flex är valt
- Högsta resonemangsnivå
- Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)
Uppskattade priser för jämförelse
Priser efter konfiguration
Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.
| Konfiguration | Prislista | Prognostiserad mängd | Debiteringsenhet | Debiteringsvillkor | Avgift |
|---|---|---|---|---|---|
| KonfigurationGrundpriser för token | PrislistaGrundpris | Prognostiserad mängd— | Debiteringsenhet— | Debiteringsvillkor— | Avgift Indata · Indatatoken · Uppskattning endast för jämförelse — / 1K token Utdata · Utdatatoken · Uppskattning endast för jämförelse — / 1K token Indata · Cacheläsning · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache, 1 tim · Uppskattning endast för jämförelse — / 1K token |
| KonfigurationVideopris | Prislista— | Prognostiserad mängd— | Debiteringsenhetper videosekund | DebiteringsvillkorInget ytterligare villkor anges i denna prisnyckel. | Avgift Utdata · Videopris · Uppskattning endast för jämförelse $0.1 per videosekund |
| KonfigurationUppskattad genereringskostnad | Prislista— | Prognostiserad mängduppskattning för en generering | Debiteringsenhet— | Debiteringsvillkor— | Avgift Utdata · Uppskattad genereringskostnad · Uppskattning endast för jämförelse $0.1 uppskattning före generering Denna uppskattning är varken en extra avgift eller ett fast pris för den slutförda genereringen. |
Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
Exempelbegäranden
Ailoot Ultra · Videor
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_INPUT_REFERENCES_JSON:?Set the actual documented input value}"
export AILOOT_INPUT_REFERENCES_JSON
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'heygen/avatar-iv', 'input_references': '${ACTUAL_OWNED_INPUT_REFERENCES}'}
request['input_references']=json.loads(os.environ['AILOOT_INPUT_REFERENCES_JSON'])
Path('request.json').write_text(json.dumps(request,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o response.bin
# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.
Ta emot och spara resultat
Ailoot Ultra · Videor
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
Spara alla färdiga resurser
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")
urls=[]
for x in r["data"]:
if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
u=urljoin("https://api.ailoot.ai",x)
z=urlsplit(u)
if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")
urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
index=$((index + 1))
done < asset-urls.txt
Behåll alla färdiga resultat
Spara varje färdig video eller returnerad fil; hämta varje faktiskt returnerad resurs-URL.
Spara hela svaret med headers, samtliga faktiska resultat, de ursprungliga returnerade identifierarna och alla användningsfält. Hämta den ursprungliga operationen utan att skicka skapandeförfrågan igen.
Om det ursprungliga svaret behöver kontrolleras
Behåll X-Client-Request-ID, X-Ailoot-Task-Id och faktiskt returnerat id/polling_url. Fortsätt med det ursprungliga jobbet; skicka inte skapandebegäran igen.
Svarsfält
| Fält | Typ |
|---|---|
Fältid | Typ |
Fältstatus | Typ |
Fältdata[] | Typ |
Fältoutputs[] | Typ |
Alias
Modellalias
Ailoot Ultra heygen/avatar-iv
Alias för metodsökvägar
Använd metodsökvägarna som visas ovan.
Relaterade anropar-ID:n
FAQ · HeyGen: Avatar IV
- Vilka indata och resultat finns?
POST /v1/videos·heygen/avatar-iv:text,image,audio,video→video- Vilka fält använder begäran?
POST /v1/videos·heygen/avatar-iv:model,input_references,prompt