HeyGen: Avatar IV
Avatar IV animerer et foto til en læbesynkroniseret talevideo, hvor ansigtsudtryk og gestustiming styres af stemmen. HeyGen dokumenterer arbejdsgange med manuskript eller optaget lyd og Photo Avatar-bevægelseskontroller til livagtige eller stiliserede præsentationsværter.
Om modellen
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
Avatar IV er HeyGens avatarmotor til at omdanne et stillbillede til en udtryksfuld talevideo. Dens diffusionsinspirerede lyd-til-udtryk-design bruger stemmetone, rytme og følelse til at styre ansigtsbevægelse, hovedhældninger, pauser og mikroudtryk. Formålet er en præsentationsvært eller figur, der leverer talt indhold med læbesynkronisering og gestik, frem for en generel scenegenerator, som skaber et helt miljø og lydspor fra en filmisk prompt.
Producenten beskriver understøttelse af livagtige og stiliserede figurer, inklusive skrå- eller profilbilleder, ansigter i anime-stil og kæledyr. Fotobaserede figurer fungerer bedst, når øjne, mund og ansigtsstruktur er lette at identificere. HeyGen anbefaler et tydeligt, velbelyst billede med naturlig positur og synlige hænder, når gestik er vigtig. Et meget lille ansigt, skjulte læber, kraftige masker, et udpræget næb eller stærkt overdrevne proportioner kan svække ansigtsbevægelse og læbesynkronisering. Hold kildeindramningen egnet til den ønskede præstation.
Producenten tilbyder to veje til taleinput. Et skrevet manuskript kombineres med en valgt stemme; et forudoptaget lydspor leverer stemme og timing direkte. Brug vejen med optaget lyd, når fremførelsen allerede er etableret, og manuskriptvejen, når talen skal syntetiseres. Disse input er alternativer i den dokumenterede grænseflade. Forbered endelig ordlyd, navne og udtale før animation, og gem lyd eller manuskript sammen med den returnerede video, så det talte resultat kan kontrolleres.
HeyGens Avatar IV-modelprofil dækker studieavatarer, Digital Twins, Photo Avatars, direkte billeder og promptskabte motiver. En genanvendelig Photo Avatar giver et stabilt motiv til senere videoer, mens en arbejdsgang med direkte billede starter fra det leverede billede. Producentens Photo Avatar-profil tilbyder bevægelsesinstruktioner i fritekst og udtryksvalg på high, medium eller low med low som standard. Behold det valgte avatarudseende og den valgte motor i en serie, så et ændret kildebillede eller en anden renderingsmodel ikke bliver en ubemærket ændring af præsentationsværten.
Til bevægelsesinstruktion skal du beskrive en synlig kropshandling og dens følelsesmæssige kvalitet. »Nikker blidt med et varmt smil« giver én gestus og ét udtryk; en kort hilsen kan bruge et venligt vink. Producenten anbefaler én hovedgestus, eventuelt sammen med et ansigtsudtryk, og højst to korte delsætninger til en sekvens. Avatar IV håndterer tempoet ud fra præstationen, så Studio-vejledningen kræver ikke en gestusplan sekund for sekund. Specifik, kort ordlyd er lettere at undersøge end flere konkurrerende handlinger i én prompt.
Producentens lyd-til-video-profil renderer op til tredive minutters leveret lyd pr. anmodning, og uploadede MP3- eller WAV-aktiver har en grænse på 32 MB. Til en længere lektion eller optagelse skal materialet deles ved sammenhængende talegrænser, og den oprindelige rækkefølge bevares. Den færdige videos taletiming skal følge den valgte lyd frem for et uvedkommende estimat for klipvarighed.
De dokumenterede producentoutputindstillinger omfatter 720p eller 1080p og formaterne 16:9, 9:16, 4:5, 5:4 eller 1:1 med en automatisk mulighed, der følger kildeproportionerne. En cover-tilpasning kan beskære motivet; contain viser hele motivet og kan lade omgivende baggrund være synlig. Lyd-til-video-arbejdsgangen returnerer MP4 som standard. Til videoavatarer kræver transparent WebM-output understøttelse af matting, og producenten anvender baggrundsfjernelse til dette output frem for at kombinere det med en ny baggrund. Undersøg den faktiske indramning og fil, før præsentationsværten placeres i en større komposition.
En undervisningsintroduktion kan bruge et tydeligt billede af præsentationsværten, en kort forklaring og én afdæmpet gestus ved nøgleinstruktionen. En produktforklaring kan beholde samme avatarudseende, mens det talte manuskript ændres til forskellige funktioner. Producenten dokumenterer også valgfrie undertekstfiler og indbrændte undertekster; gennemgå ordlyd og timing sammen med talen. Rendering er asynkron i producentgrænsefladen, så et oprettelsessvar og den færdige video er forskellige artefakter. Gem den færdige optagelse og dens færdiggørelsestilstand sammen med opgavens resultat.
Avatar IV forbliver adskilt fra Avatar V's referencedrevne bevægelse og særskilte Studio-forudindstillingskontroller. Den er også adskilt fra HeyGen Videos generelle scenegenerering og fra en interaktiv samtale med en liveavatar. Gennemgå de renderede mundbevægelser, synlige hænder, ansigtsudtryk, pauser og talte ord i forhold til kildematerialet og den ønskede tone. Billede, positur, lys og bevægelsesinstruktioner påvirker resultatet; en fotobaseret animation skal kontrolleres som en genereret præstation med de valgte input bevaret til senere revisioner.
Ailoot Ultra · Videoer POST /v1/videos heygen/avatar-iv
heygen/avatar-ivStart
Avatar IV animerer et foto til en læbesynkroniseret talevideo, hvor ansigtsudtryk og gestustiming styres af stemmen. HeyGen dokumenterer arbejdsgange med manuskript eller optaget lyd og Photo Avatar-bevægelseskontroller til livagtige eller stiliserede præsentationsværter.
- Accepterede input
- Tekst · Billeder · Lyd · Video
- Resultater
- Video
Tilgængelig i Ailoot · input og metoder
Ailoot Ultra · Videoer POST /v1/videos
- Inputtyper
text,image,audio,video- Outputtyper
video
| Felt | Type | Krav | Værdier og grænser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser heygen/avatar-iv | Standard— |
Feltinput_references | Typearray | KravPåkrævet | Værdier og grænser Minimumsantal elementer: 2 Maksimalt antal elementer: 2 | Standard— |
Feltprompt | Typestring | KravValgfrit | Værdier og grænser | Standard— |
Metodeparametre og livscyklus
| Parameter | Kontrakt |
|---|---|
Parametercontent_type | Kontraktapplication/json |
Parameterrequired | Kontraktmodel, input_references |
Parametermaterial_types | Kontrakttext, image, audio, video |
Parametermaterial_conditions | KontraktBrug faktiske indholds-URL’er til færdige medieaktiver, du ejer, med deres returnerede signaturer: én videokilde til BFL eller én billedkilde og én lydkilde til en avatar. Der kræves dokumentation for kildens ejer, type og bytes., Angiv præcis ét PNG/JPEG-billedaktiv og ét WAV/MP3-lydaktiv. Lyden må højst fylde 32000000 bytes, med en varighed større end 0 og højst 1800 sekunder. |
Livscyklus: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · det faktisk returnerede id eller polling_url
GET /v1/videos/{request_id}/content
Priser
Sådan beregnes det endelige beløb
De viste satser bruges til at anslå omkostningen før genereringen. Det endelige beløb beregnes ud fra den registrerede omkostning for den oprindelige generering. Den målte varighed af outputtet og de anslåede mængder er ikke den endelige fakturerbare mængde.
Tarifoplysninger tilføjer ikke anmodningsmuligheder. Understøttede parametre står ved den valgte metode.
- Hurtig tilstand
- Ikke angivet Når hurtig tilstand er valgt
- flex-tilstand
- Ikke angivet Når flex-tilstanden er valgt
- Maksimal ræsonneringsindsats
- Ikke angivet Når default-justeringen anvendes ved maksimal ræsonneringsindsats
Estimerede takster til sammenligning
Priser efter konfiguration
Knyt hver omkostning til de viste betingelser. Brug én takst for hver gruppe af alternative konfigurationer.
| Konfiguration | Takstplan | Forventet mængde | Afregningsenhed | Afregningsbetingelser | Beløb |
|---|---|---|---|---|---|
| KonfigurationGrundpriser for tokens | TakstplanGrundtakst | Forventet mængde— | Afregningsenhed— | Afregningsbetingelser— | Beløb Input · Inputtokens · Estimat kun til sammenligning — / 1K tokens Output · Outputtokens · Estimat kun til sammenligning — / 1K tokens Input · Cachelæsning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning, 1 time · Estimat kun til sammenligning — / 1K tokens |
| KonfigurationVideopris | Takstplan— | Forventet mængde— | Afregningsenhedpr. videosekund | AfregningsbetingelserDer er ikke angivet nogen yderligere betingelse i denne prisnøgle. | Beløb Output · Videopris · Estimat kun til sammenligning $0.1 pr. videosekund |
| KonfigurationAnslået genereringsomkostning | Takstplan— | Forventet mængdeestimat for én generering | Afregningsenhed— | Afregningsbetingelser— | Beløb Output · Anslået genereringsomkostning · Estimat kun til sammenligning $0.1 estimat før generering Dette estimat er hverken et ekstra gebyr eller en fast pris for den færdige generering. |
Ailoot reserverer et estimeret beløb før en anmodning. Efter resultatet afregnes det endelige beløb ud fra det målte forbrug. Ved streaming bruges den endelige forbrugsregistrering til afregningen. Sådan fungerer reservation og afregning →
Eksempelanmodninger
Ailoot Ultra · Videoer
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.
Hent og gem resultater
Ailoot Ultra · Videoer
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
Gem alle færdige filer
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 færdige resultater
Gem hver færdig video eller returneret fil; hent hver faktisk returneret fil-URL.
Gem hele svaret og alle headere, alle faktisk returnerede output, de oprindeligt returnerede identifikatorer og alle felter med forbrugsdata. Gendan den oprindelige operation uden at sende oprettelsesanmodningen igen.
Hvis det oprindelige svar skal kontrolleres
Behold X-Client-Request-ID, X-Ailoot-Task-Id og det faktisk returnerede id/polling_url. Fortsæt det oprindelige job; indsend ikke oprettelsen igen.
Svarfelter
| Felt | Type |
|---|---|
Feltid | Type |
Feltstatus | Type |
Feltdata[] | Type |
Feltoutputs[] | Type |
Aliaser
Modelaliaser
Ailoot Ultra heygen/avatar-iv
Aliaser for metodestier
Brug metodestierne vist ovenfor.
Relaterede kalder-ID’er
FAQ · HeyGen: Avatar IV
- Hvilke input og resultater er tilgængelige?
POST /v1/videos·heygen/avatar-iv:text,image,audio,video→video- Hvilke felter bruger anmodningen?
POST /v1/videos·heygen/avatar-iv:model,input_references,prompt