HeyGen: Avatar IV
Avatar IV animeert een foto tot een sprekende video met lipsynchronisatie, waarbij gezichtsuitdrukking en gebarentiming door de stem worden gestuurd. HeyGen beschrijft workflows met scripts of opgenomen audio en Photo Avatar-bewegingsregelaars voor levensechte of gestileerde presentatoren.
Over het model
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Avatar IV is de avatarengine van HeyGen die een stilstaand beeld omzet in een expressieve sprekende video. Het door diffusie geïnspireerde audio-naar-expressieontwerp gebruikt stemtoon, ritme en emotie om gezichtsbeweging, hoofdbewegingen, pauzes en micro-expressies te sturen. Het doel is een presentator of personage dat gesproken inhoud met lipsynchronisatie en gebaren overbrengt, in plaats van een algemene scènegenerator die een volledige omgeving en soundtrack uit een filmische prompt creëert.
De fabrikant beschrijft ondersteuning voor levensechte en gestileerde personages, waaronder beelden onder een hoek of in profiel, animegezichten en huisdieren. Personages op basis van foto's werken het best wanneer ogen, mond en gezichtsstructuur gemakkelijk te herkennen zijn. HeyGen beveelt een duidelijk, goed belicht beeld met een natuurlijke houding en zichtbare handen aan wanneer gebaren belangrijk zijn. Een zeer klein gezicht, verborgen lippen, zware maskers, een uitgesproken snavel of sterk overdreven verhoudingen kunnen gezichtsbeweging en lipsynchronisatie verzwakken. Houd de bronkadrering geschikt voor de bedoelde uitvoering.
De producent biedt twee routes voor spraakinvoer. Een geschreven script wordt met een geselecteerde stem gecombineerd; een vooraf opgenomen audiotrack levert stem en timing rechtstreeks. Gebruik de route met opgenomen audio wanneer de voordracht al vastligt en de scriptroute wanneer de spraak moet worden gesynthetiseerd. Deze invoervormen zijn alternatieven in de gedocumenteerde interface. Bereid de definitieve formulering, namen en uitspraak vóór de animatie voor en bewaar audio of script bij de teruggegeven video zodat het gesproken resultaat kan worden gecontroleerd.
Het Avatar IV-modelprofiel van HeyGen omvat studioavatars, Digital Twins, Photo Avatars, directe beelden en via prompts gecreëerde onderwerpen. Een herbruikbare Photo Avatar biedt een stabiel onderwerp voor latere video's, terwijl een workflow met een direct beeld vanuit de aangeleverde afbeelding begint. Het Photo Avatar-profiel van de producent biedt bewegingsinstructies in vrije tekst en expressiviteitskeuzes van high, medium of low, met low als standaard. Behoud het gekozen avataruiterlijk en de engine bij het maken van een reeks zodat een gewijzigd bronbeeld of rendermodel geen onopgemerkte verandering van presentator wordt.
Beschrijf voor bewegingsregie een zichtbare lichaamsactie en de emotionele kwaliteit ervan. “Knikt zacht met een warme glimlach” geeft één gebaar en één uitdrukking; een korte begroeting kan een vriendelijk zwaaigebaar gebruiken. De maker beveelt één hoofdgebaar aan, eventueel gecombineerd met een gezichtsuitdrukking, en maximaal twee korte zinsdelen voor een reeks. Avatar IV haalt het tempo uit de uitvoering, dus de Studio-gids vereist geen gebarenschema per seconde. Specifieke, beknopte formulering is gemakkelijker te controleren dan meerdere tegenstrijdige acties in één prompt.
Het audio-naar-videoprofiel van de producent rendert maximaal dertig minuten aangeleverde audio per verzoek en geüploade MP3- of WAV-bestanden hebben een limiet van 32 MB. Verdeel het materiaal voor een langere les of opname op samenhangende spraakgrenzen en behoud de oorspronkelijke volgorde. De timing van de spraak in de definitieve video moet de geselecteerde audio volgen en geen niet-gerelateerde schatting van de cliplengte.
De gedocumenteerde uitvoerinstellingen van de producent omvatten 720p of 1080p en vormen van 16:9, 9:16, 4:5, 5:4 of 1:1, met een automatische optie die de bronverhoudingen volgt. Een cover-fit kan het onderwerp bijsnijden; contain past het hele onderwerp in en kan de omliggende achtergrond zichtbaar laten. De audio-naar-videoworkflow geeft standaard MP4 terug. Voor videoavatars vereist transparante WebM-uitvoer ondersteuning voor matting en past de producent achtergrondverwijdering voor die uitvoer toe, in plaats van deze met een nieuwe achtergrond te combineren. Controleer de daadwerkelijke kadrering en het bestand voordat u de presentator in een grotere compositie plaatst.
Een trainingsinleiding kan een goed herkenbaar presentatorbeeld, een beknopte uitleg en één ingetogen gebaar bij de belangrijkste instructie gebruiken. Een productuitleg kan hetzelfde avataruiterlijk behouden en het gesproken script voor verschillende functies veranderen. De producent beschrijft ook optionele ondertitelbestanden en ingebrande ondertitels; controleer hun formulering en timing naast de spraak. Renderen is asynchroon in de interface van de maker, dus een aanmaakantwoord en de voltooide video zijn verschillende artefacten. Bewaar de voltooide opname en de voltooiingsstatus bij het taakresultaat.
Avatar IV blijft gescheiden van de referentiegestuurde beweging van Avatar V en de afzonderlijke Studio-presetregelaars daarvan. Het staat ook los van de algemene scènegeneratie van HeyGen Video en van een interactief liveavatargesprek. Controleer de gerenderde mondbeweging, zichtbare handen, gezichtsuitdrukking, pauzes en gesproken formulering aan de hand van het bronmateriaal en de bedoelde toon. Beeld, houding, belichting en bewegingsinstructies beïnvloeden het resultaat; een animatie op basis van een foto moet als gegenereerde uitvoering worden gecontroleerd, met behoud van de gekozen invoer voor latere herzieningen.
Ailoot Ultra · Videogeneratie POST /v1/videos heygen/avatar-iv
heygen/avatar-ivAan de slag
Avatar IV animeert een foto tot een sprekende video met lipsynchronisatie, waarbij gezichtsuitdrukking en gebarentiming door de stem worden gestuurd. HeyGen beschrijft workflows met scripts of opgenomen audio en Photo Avatar-bewegingsregelaars voor levensechte of gestileerde presentatoren.
- Toegestane invoer
- Tekst · Afbeeldingen · Audio · Video
- Resultaten
- Video
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Videogeneratie POST /v1/videos
- Invoer
text,image,audio,video- Uitvoer
video
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten heygen/avatar-iv | Standaard— |
Veldinput_references | Typearray | VereisteVereist | Waarden en limieten Minimumaantal items: 2 Maximumaantal items: 2 | Standaard— |
Veldprompt | Typestring | VereisteOptioneel | Waarden en limieten | Standaard— |
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, input_references |
Parametermaterial_types | Contracttext, image, audio, video |
Parametermaterial_conditions | ContractGebruik werkelijke inhouds-URL's van voltooide media-assets die je toebehoren, met hun teruggestuurde handtekeningen: één videobron voor BFL, of één afbeeldingsbron en één audiobron voor een avatar. Het bewijs uit Source van eigenaar, type en bytes is verplicht., Lever precies één PNG/JPEG-afbeelding en één WAV/MP3-audio-asset aan. De audio bedraagt hoogstens 32000000 bytes, met een duur groter dan 0 en hoogstens 1800 seconden. |
Levenscyclus: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · werkelijk teruggestuurde id of polling_url
GET /v1/videos/{request_id}/content
Tarieven
Zo worden de uiteindelijke kosten berekend
De getoonde tarieven ramen de kosten vóór de generatie. De definitieve kosten worden berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van het gegenereerde resultaat en de geraamde hoeveelheden vormen niet de definitieve factureerbare hoeveelheid.
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus geselecteerd is
- Flex-modus
- Niet opgegeven Wanneer de flex-modus geselecteerd is
- Maximale redeneerinspanning
- Niet opgegeven Wanneer voor maximale redeneerinspanning de default-aanpassing wordt gebruikt
Geschatte tarieven ter vergelijking
Prijzen per configuratie
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Rekeneenheid | Factureringsvoorwaarden | Kosten |
|---|---|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte hoeveelheid— | Rekeneenheid— | Factureringsvoorwaarden— | Kosten Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens |
| ConfiguratieVideoprijs | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper videoseconde | FactureringsvoorwaardenIn deze prijssleutel is geen bijkomende voorwaarde opgegeven. | Kosten Uitvoer · Videoprijs · Schatting uitsluitend ter vergelijking $0.1 per videoseconde |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Rekeneenheid— | Factureringsvoorwaarden— | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.1 schatting vóór generatie Deze raming is geen extra kost of vast tarief voor de voltooide generatie. |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Voorbeeldverzoeken
Ailoot Ultra · Videogeneratie
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.
Resultaten ophalen en opslaan
Ailoot Ultra · Videogeneratie
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
Alle voltooide bestanden opslaan
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
Alle voltooide resultaten bewaren
Sla elke voltooide video of elk teruggegeven bestand op; haal elke daadwerkelijk teruggegeven bestands-URL op.
Bewaar de volledige respons en headers, iedere daadwerkelijke uitvoer, de oorspronkelijk teruggegeven identificatoren en alle verbruiksvelden. Herstel de oorspronkelijke bewerking zonder de aanmaakaanvraag opnieuw in te dienen.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar X-Client-Request-ID, X-Ailoot-Task-Id en de werkelijk teruggestuurde id/polling_url. Zet de oorspronkelijke opdracht voort; dien de aanmaakaanvraag niet opnieuw in.
Antwoordvelden
| Veld | Type |
|---|---|
Veldid | Type |
Veldstatus | Type |
Velddata[] | Type |
Veldoutputs[] | Type |
Aliasnamen
Modelaliasnamen
Ailoot Ultra heygen/avatar-iv
Aliasnamen voor methodepaden
Gebruik de hierboven getoonde methodepaden.
Gerelateerde aanroeper-ID’s
FAQ · HeyGen: Avatar IV
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/videos·heygen/avatar-iv:text,image,audio,video→video- Welke velden gebruikt het verzoek?
POST /v1/videos·heygen/avatar-iv:model,input_references,prompt