HeyGen: Avatar IV
Avatar IV animerer et foto til en leppesynkronisert talevideo, med ansiktsuttrykk og gesttiming styrt av stemmen. HeyGen dokumenterer arbeidsflyter med manus eller innspilt lyd og Photo Avatar-bevegelseskontroller for livaktige eller stiliserte presentatører.
Om modellen
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
Avatar IV er HeyGens avatarmotor for å gjøre et stillbilde om til en uttrykksfull talevideo. Den diffusjonsinspirerte lyd-til-uttrykk-utformingen bruker stemmetone, rytme og følelse til å styre ansiktsbevegelse, hodehelling, pauser og mikrouttrykk. Formålet er en presentatør eller karakter som leverer muntlig innhold med leppesynkronisering og gester, fremfor en generell scenegenerator som lager hele omgivelser og lydspor fra en filmatisk prompt.
Produsenten beskriver støtte for livaktige og stiliserte karakterer, inkludert skrå- eller profilbilder, anime-ansikter og kjæledyr. Fotobaserte karakterer fungerer best når øyne, munn og ansiktsstruktur er lette å identifisere. HeyGen anbefaler et tydelig, godt belyst bilde med naturlig holdning og synlige hender når gester betyr noe. Et svært lite ansikt, skjulte lepper, tunge masker, et markert nebb eller sterkt overdrevne proporsjoner kan svekke ansiktsbevegelse og leppesynkronisering. Tilpass kildeutsnittet til ønsket fremføring.
Produsenten gir to veier for taleinndata. Et skriftlig manus kobles til en valgt stemme; et forhåndsinnspilt lydspor gir stemme og timing direkte. Bruk veien med innspilt lyd når fremføringen allerede er etablert, og manusveien når talen må syntetiseres. Inndataene er alternativer i det dokumenterte grensesnittet. Forbered endelig ordlyd, navn og uttale før animasjon og bevar lyd eller manus sammen med den returnerte videoen slik at taleresultatet kan kontrolleres.
HeyGens Avatar IV-modellprofil dekker studioavatarer, Digital Twins, Photo Avatars, direktebilder og promptskapte motiver. En gjenbrukbar Photo Avatar gir et stabilt motiv til senere videoer, mens en direktebildearbeidsflyt starter fra det oppgitte bildet. Produsentens Photo Avatar-profil tilbyr bevegelsesinstruksjoner i fritekst og uttrykksvalg på high, medium eller low, med low som standard. Behold valgt avatarutseende og motor når du lager en serie, slik at et endret kildebilde eller en endret rendringsmodell ikke blir en ubemerket endring av presentatøren.
Til bevegelsesregi beskriver du en synlig kroppshandling og dens følelsesmessige kvalitet. «Nikker forsiktig med et varmt smil» gir én gest og ett uttrykk; en kort hilsen kan bruke et vennlig vink. Produsenten anbefaler én hovedgest, eventuelt sammen med et ansiktsuttrykk, og høyst to korte setningsledd til en sekvens. Avatar IV håndterer tempo fra fremføringen, så Studio-veiledningen krever ikke en gestplan sekund for sekund. Spesifikk, kort ordlyd er lettere å undersøke enn flere konkurrerende handlinger i én prompt.
Produsentens lyd-til-video-profil rendrer opptil tretti minutter oppgitt lyd per forespørsel, og opplastede MP3- eller WAV-ressurser har en grense på 32 MB. Til en lengre leksjon eller et opptak deler du materialet ved sammenhengende talegrenser og beholder originalrekkefølgen. Sluttvideoens taletiming bør følge valgt lyd fremfor et urelatert anslag på klippvarighet.
De dokumenterte utdatainnstillingene omfatter 720p eller 1080p og former på 16:9, 9:16, 4:5, 5:4 eller 1:1, med et automatisk alternativ som følger kildens proporsjoner. En cover-tilpasning kan beskjære motivet; contain får plass til hele motivet og kan la omkringliggende bakgrunn være synlig. Lyd-til-video-arbeidsflyten returnerer MP4 som standard. Til videoavatarer krever transparente WebM-utdata støtte for matting, og produsenten bruker bakgrunnsfjerning til disse utdataene i stedet for å kombinere dem med en ny bakgrunn. Undersøk faktisk utsnitt og fil før presentatøren plasseres i en større komposisjon.
En opplæringsintroduksjon kan bruke et tydelig presentatørbilde, en kort forklaring og én dempet gest ved hovedinstruksjonen. En produktforklaring kan beholde samme avatarutseende mens talemanuset endres for ulike funksjoner. Produsenten dokumenterer også valgfrie undertekstfiler og innbrente undertekster; gjennomgå ordlyd og timing sammen med talen. Rendering er asynkron i produsentgrensesnittet, så et opprettelsessvar og den fullførte videoen er forskjellige resultater. Oppbevar det ferdige opptaket og fullføringsstatusen sammen med oppgavens resultat.
Avatar IV er fortsatt forskjellig fra Avatar Vs referansestyrte bevegelse og separate forhåndsdefinerte Studio-kontroller. Den er også forskjellig fra HeyGen Videos generelle scenegenerering og fra en interaktiv samtale med en sanntidsavatar. Gjennomgå gjengitt munnbevegelse, synlige hender, ansiktsuttrykk, pauser og muntlig ordlyd opp mot kildemateriale og ønsket tone. Bilde, positur, belysning og bevegelsesinstruksjoner påvirker resultatet; en fotobasert animasjon bør kontrolleres som en generert fremføring, med valgte inndata beholdt til senere revisjoner.
Ailoot Ultra · Videogenerering POST /v1/videos heygen/avatar-iv
heygen/avatar-ivStart
Avatar IV animerer et foto til en leppesynkronisert talevideo, med ansiktsuttrykk og gesttiming styrt av stemmen. HeyGen dokumenterer arbeidsflyter med manus eller innspilt lyd og Photo Avatar-bevegelseskontroller for livaktige eller stiliserte presentatører.
- Godkjente inndata
- Tekst · Bilder · Lyd · Video
- Resultater
- Video
Tilgjengelig i Ailoot · inndata & metoder
Ailoot Ultra · Videogenerering POST /v1/videos
- Inndatatyper
text,image,audio,video- Utdatatyper
video
| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser heygen/avatar-iv | Standard— |
Feltinput_references | Typearray | KravPåkrevd | Verdier & grenser Minste antall elementer: 2 Maksimalt antall elementer: 2 | Standard— |
Feltprompt | Typestring | KravValgfritt | Verdier & grenser | Standard— |
Metodeparametere og livssyklus
| Parameter | Avtale |
|---|---|
Parametercontent_type | Avtaleapplication/json |
Parameterrequired | Avtalemodel, input_references |
Parametermaterial_types | Avtaletext, image, audio, video |
Parametermaterial_conditions | AvtaleBruk faktiske innholdsadresser for ferdigstilte medieressurser du eier, med de returnerte signaturene: én videokilde for BFL, eller én bilde- og én lydkilde for avatar. Dokumentasjon fra kildekoden av eier, type og byte er påkrevd., Oppgi nøyaktig ett PNG/JPEG-bilde og én WAV/MP3-lydressurs. Lyden er høyst 32000000 byte, med varighet større enn 0 og høyst 1800 sekunder. |
Livssyklus: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · Faktisk returnert id eller polling_url
GET /v1/videos/{request_id}/content
Priser
Slik beregnes det endelige beløpet
De viste satsene anslår kostnaden før generering. Det endelige beløpet beregnes ut fra kostnaden som er registrert for den opprinnelige genereringen. Målt varighet på utdataene og anslåtte mengder er ikke den endelige fakturerbare mengden.
Tariffopplysninger legger ikke til forespørselsvalg. Støttede parametere står ved den valgte metoden.
- Hurtigmodus
- Ikke angitt Når hurtigmodus er valgt
- Flex-modus
- Ikke angitt Når flex-modus er valgt
- Maksimal resonneringsinnsats
- Ikke angitt Når justeringen «default» brukes for maksimal resonneringsinnsats
Estimerte satser for sammenligning
Priser etter konfigurasjon
Knytt hver kostnad til de viste vilkårene. Bruk én sats for hvert sett med alternative konfigurasjoner.
| Konfigurasjon | Prisplan | Forventet mengde | Faktureringsenhet | Faktureringsvilkår | Kostnad |
|---|---|---|---|---|---|
| KonfigurasjonGrunnpriser for tokener | PrisplanGrunnsats | Forventet mengde— | Faktureringsenhet— | Faktureringsvilkår— | Kostnad Inndata · Inngående tokener · Estimat kun for sammenligning — / 1K tokener Utdata · Utgående tokener · Estimat kun for sammenligning — / 1K tokener Inndata · Lesing fra hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer, 1 time · Estimat kun for sammenligning — / 1K tokener |
| KonfigurasjonVideopris | Prisplan— | Forventet mengde— | Faktureringsenhetper videosekund | FaktureringsvilkårIngen ytterligere betingelse er angitt i denne prisnøkkelen. | Kostnad Utdata · Videopris · Estimat kun for sammenligning $0.1 per videosekund |
| KonfigurasjonAnslått genereringskostnad | Prisplan— | Forventet mengdeestimat for én generering | Faktureringsenhet— | Faktureringsvilkår— | Kostnad Utdata · Anslått genereringskostnad · Estimat kun for sammenligning $0.1 estimat før generering Dette anslaget er verken en tilleggsavgift eller en fast sats for den fullførte genereringen. |
Ailoot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →
Eksempelforespørsler
Ailoot Ultra · Videogenerering
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.
Motta og lagre resultater
Ailoot Ultra · Videogenerering
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
Lagre alle ferdige ressurser
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
Behold alle ferdige resultater
Lagre hver ferdige video eller returnerte fil; hent hver faktisk returnerte ressurs-URL.
Bevar hele svaret og svarhodene, alle faktiske utdata, de opprinnelige returnerte identifikatorene og alle bruksfeltene. Hent den opprinnelige operasjonen igjen uten å sende opprettelsesforespørselen på nytt.
Hvis det opprinnelige svaret må kontrolleres
Behold X-Client-Request-ID, X-Ailoot-Task-Id og faktisk returnert id/polling_url. Fortsett den opprinnelige jobben; ikke send inn opprettelsen på nytt.
Svarfelter
| Felt | Type |
|---|---|
Feltid | Type |
Feltstatus | Type |
Feltdata[] | Type |
Feltoutputs[] | Type |
Aliaser
Modellaliaser
Ailoot Ultra heygen/avatar-iv
Aliaser for metodestier
Bruk metodestiene som vises ovenfor.
Tilknyttede anroper-ID-er
FAQ · HeyGen: Avatar IV
- Hvilke inndata og resultater er tilgjengelige?
POST /v1/videos·heygen/avatar-iv:text,image,audio,video→video- Hvilke felt bruker forespørselen?
POST /v1/videos·heygen/avatar-iv:model,input_references,prompt