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, kantelingen van het hoofd, 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 · Videomateriaal 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 · Videomateriaal POST /v1/videos
- Invoertypen
text,image,audio,video- Uitvoertypen
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 de daadwerkelijke inhouds-URLs van voltooide media-assets die u bezit, met de geretourneerde handtekeningen: één videobron voor BFL, of één afbeeldings- en één audiobron voor avatar. Het Source-bewijs voor eigenaar/type/bytes is vereist., Lever precies één PNG/JPEG-afbeelding en één WAV/MP3-audio-asset aan. De audio is maximaal 32000000 bytes, met een duur groter dan 0 en maximaal 1800 seconden. |
Levenscyclus: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · daadwerkelijk geretourneerde id of polling_url
GET /v1/videos/{request_id}/content
Tarieven
Zo worden de uiteindelijke kosten berekend
De weergegeven tarieven geven een schatting van de kosten vóór de generatie. Het definitieve bedrag wordt berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van de uitvoer en de geschatte hoeveelheden zijn 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 is geselecteerd
- Flexmodus
- Niet opgegeven Wanneer de modus flex is geselecteerd
- Maximale redeneerinspanning
- Niet opgegeven Wanneer bij 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 aanvullende voorwaarde vastgelegd. | 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 schatting is geen extra bedrag 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 · Videomateriaal
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 · Videomateriaal
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 het volledige antwoord en de headers, alle daadwerkelijke uitvoer, de oorspronkelijk geretourneerde identificatoren en alle gebruiksvelden. 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 daadwerkelijk geretourneerde id/polling_url. Ga door met de oorspronkelijke taak; dien de aanmaak 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