HeyGen: Avatar IV
Avatar IV anima una foto in un video parlato con sincronizzazione labiale, espressioni del volto e tempi dei gesti guidati dalla voce. HeyGen documenta flussi da script o audio registrato e controlli di movimento Photo Avatar per presentatori realistici o stilizzati.
Informazioni sul modello
Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.
Avatar IV è il motore di avatar di HeyGen che trasforma un’immagine fissa in un video parlato espressivo. Il suo sistema che ricava le espressioni dall’audio, ispirato alla diffusione, usa tono vocale, ritmo ed emozione per guidare movimenti del volto, inclinazioni della testa, pause e microespressioni. Lo scopo è un presentatore o personaggio che pronuncia contenuti con sincronizzazione labiale e gesti, invece di un generatore generalista di scene che crea un’intera ambientazione e colonna sonora da un prompt cinematografico.
Il produttore descrive il supporto di personaggi realistici e stilizzati, comprese immagini angolate o di profilo, volti in stile anime e animali domestici. I personaggi basati su foto funzionano meglio quando occhi, bocca e struttura del volto sono facili da identificare. HeyGen consiglia un’immagine chiara e ben illuminata, con postura naturale e mani visibili quando i gesti sono importanti. Un volto molto piccolo, labbra nascoste, maschere coprenti, un becco pronunciato o proporzioni molto esagerate possono indebolire movimento facciale e sincronizzazione labiale. Mantieni l’inquadratura sorgente adatta all’interpretazione prevista.
Il produttore offre due percorsi di ingresso per il parlato. Uno script scritto viene abbinato a una voce selezionata; una traccia audio preregistrata fornisce direttamente voce e tempi. Usa il percorso da audio registrato quando l’interpretazione è già definita e quello da script quando il parlato deve essere sintetizzato. Questi input sono alternativi nell’interfaccia documentata. Prepara formulazione finale, nomi e pronuncia prima dell’animazione e conserva audio o script insieme al video restituito, così il risultato parlato può essere verificato.
Il profilo del modello Avatar IV di HeyGen copre avatar da studio, Digital Twins, Photo Avatars, immagini dirette e soggetti creati da prompt. Un Photo Avatar riutilizzabile fornisce un soggetto stabile per video successivi, mentre un flusso da immagine diretta parte dalla fotografia fornita. Il profilo Photo Avatar del produttore offre istruzioni di movimento in testo libero e livelli di espressività high, medium o low, con low come valore predefinito. Mantieni aspetto dell’avatar e motore scelti quando crei una serie, così un’immagine sorgente o un modello di rendering cambiati non diventano un cambiamento inosservato del presentatore.
Per dirigere il movimento, descrivi un’azione corporea visibile e la sua qualità emotiva. «Annuisce delicatamente con un sorriso caloroso» fornisce un gesto e un’espressione; un breve saluto può usare un cenno amichevole della mano. Il produttore consiglia un gesto principale, eventualmente abbinato a un’espressione del volto, e non più di due brevi proposizioni per una sequenza. Avatar IV gestisce il ritmo dall’interpretazione, quindi la guida Studio non richiede un programma dei gesti secondo per secondo. Una formulazione specifica e concisa è più facile da controllare di più azioni concorrenti in un unico prompt.
Il profilo da audio a video del produttore renderizza fino a trenta minuti di audio fornito per richiesta, e le risorse MP3 o WAV caricate hanno un limite di 32 MB. Per una lezione o registrazione più lunga, dividi il materiale in corrispondenza di confini coerenti del parlato e conserva l’ordine originale. I tempi del parlato del video finale devono seguire l’audio selezionato invece di una stima scollegata della durata del clip.
Le impostazioni documentate di output del produttore comprendono 720p o 1080p e formati 16:9, 9:16, 4:5, 5:4 o 1:1, con un’opzione automatica che segue le proporzioni della sorgente. L’adattamento cover può ritagliare il soggetto; contain fa entrare l’intero soggetto e può lasciare visibile lo sfondo circostante. Il flusso da audio a video restituisce MP4 per impostazione predefinita. Per gli avatar video, l’output WebM trasparente richiede il supporto dello scontorno, e il produttore applica la rimozione dello sfondo per quell’output invece di combinarlo con un nuovo sfondo. Controlla inquadratura effettiva e file prima di inserire il presentatore in una composizione più grande.
Un’introduzione formativa può usare un’immagine leggibile del presentatore, una spiegazione concisa e un gesto contenuto in corrispondenza dell’istruzione essenziale. Una spiegazione di prodotto può mantenere lo stesso aspetto dell’avatar cambiando lo script parlato per funzionalità diverse. Il produttore documenta anche file facoltativi di sottotitoli e sottotitoli sovraimpressi; controllane testo e tempi insieme al parlato. Il rendering è asincrono nell’interfaccia del produttore, quindi una risposta di creazione e il video completato sono risultati differenti. Conserva la registrazione finita e il suo stato di completamento insieme al risultato dell’attività.
Avatar IV resta distinto dal movimento guidato da riferimenti di Avatar V e dai suoi controlli separati di preset Studio. È inoltre distinto dalla generazione generalista di scene di HeyGen Video e da una conversazione con avatar interattivo in diretta. Controlla movimento della bocca renderizzato, mani visibili, espressioni del volto, pause e parole pronunciate rispetto al materiale sorgente e al tono desiderato. Immagine, posa, illuminazione e istruzioni di movimento influenzano il risultato; un’animazione basata su foto va controllata come un’interpretazione generata, conservando gli input scelti per revisioni successive.
Ailoot Ultra · Generazione video POST /v1/videos heygen/avatar-iv
heygen/avatar-ivIntroduzione
Avatar IV anima una foto in un video parlato con sincronizzazione labiale, espressioni del volto e tempi dei gesti guidati dalla voce. HeyGen documenta flussi da script o audio registrato e controlli di movimento Photo Avatar per presentatori realistici o stilizzati.
- Input accettati
- Testo · Immagini · Audio · Video
- Risultati
- Video
Disponibile in Ailoot · input e metodi
Ailoot Ultra · Generazione video POST /v1/videos
- Tipi di input
text,image,audio,video- Tipi di output
video
| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti heygen/avatar-iv | Predefinito— |
Campoinput_references | Tipoarray | RequisitoObbligatorio | Valori e limiti Numero minimo di elementi: 2 Numero massimo di elementi: 2 | Predefinito— |
Campoprompt | Tipostring | RequisitoFacoltativo | Valori e limiti | Predefinito— |
Parametri e ciclo di vita del metodo
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, input_references |
Parametromaterial_types | Contrattotext, image, audio, video |
Parametromaterial_conditions | ContrattoUsa URL reali dei contenuti di risorse multimediali completate di tua proprietà con le firme restituite: una sorgente video per BFL oppure una sorgente immagine e una sorgente audio per avatar. È richiesta la prova di proprietario, tipo e byte prevista dal codice sorgente., Fornisci esattamente un'immagine PNG/JPEG e una risorsa audio WAV/MP3. L'audio non deve superare 32000000 byte, con durata maggiore di 0 e non superiore a 1800 secondi. |
Ciclo di vita: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · id o polling_url effettivamente restituito
GET /v1/videos/{request_id}/content
Tariffe
Calcolo del costo finale
Le tariffe visualizzate stimano il costo prima della generazione. L'addebito finale viene calcolato in base al costo registrato per la generazione originale. La durata misurata dell'output e le quantità previste non costituiscono la quantità finale fatturabile.
Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.
- Modalità rapida
- Non specificato Quando è selezionata la modalità rapida
- Modalità flex
- Non specificato Quando è selezionata la modalità flex
- Sforzo massimo di ragionamento
- Non specificato Quando lo sforzo massimo di ragionamento usa l'adeguamento predefinito (default)
Tariffe stimate per il confronto
Prezzi per configurazione
Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.
| Configurazione | Listino delle tariffe | Quantità prevista | Unità di fatturazione | Condizioni di fatturazione | Costo |
|---|---|---|---|---|---|
| ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Quantità prevista— | Unità di fatturazione— | Condizioni di fatturazione— | Costo Input · Token in input · Stima solo a fini di confronto — / 1K token Output · Token in output · Stima solo a fini di confronto — / 1K token Input · Lettura dalla cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache, 1 ora · Stima solo a fini di confronto — / 1K token |
| ConfigurazionePrezzo del video | Listino delle tariffe— | Quantità prevista— | Unità di fatturazioneper secondo di video | Condizioni di fatturazioneIn questa chiave tariffaria non è dichiarata alcuna condizione aggiuntiva. | Costo Output · Prezzo del video · Stima solo a fini di confronto $0.1 per secondo di video |
| ConfigurazioneCosto stimato della generazione | Listino delle tariffe— | Quantità previstastima per una generazione | Unità di fatturazione— | Condizioni di fatturazione— | Costo Output · Costo di generazione stimato · Stima solo a fini di confronto $0.1 stima prima della generazione Questa stima non è un addebito aggiuntivo né una tariffa fissa per la generazione completata. |
Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →
Esempi di richieste
Ailoot Ultra · Generazione video
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.
Ricevi e salva i risultati
Ailoot Ultra · Generazione video
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
Salva tutte le risorse completate
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
Conserva tutti i risultati completati
Salva ogni video completato o file restituito; recupera ogni URL di risorsa effettivamente restituito.
Conserva la risposta completa e gli header, ogni output effettivo, gli identificatori originali restituiti e tutti i campi di utilizzo. Recupera l'operazione originale senza inviare nuovamente la richiesta di creazione.
Se occorre verificare la risposta originale
Conserva X-Client-Request-ID, X-Ailoot-Task-Id e id/polling_url effettivamente restituiti. Prosegui con l'attività originale; non inviare nuovamente la richiesta di creazione.
Campi della risposta
| Campo | Tipo |
|---|---|
Campoid | Tipo |
Campostatus | Tipo |
Campodata[] | Tipo |
Campooutputs[] | Tipo |
Alias
Alias del modello
Ailoot Ultra heygen/avatar-iv
Alias dei percorsi dei metodi
Usa i percorsi dei metodi indicati sopra.
ID di chiamata correlati
FAQ · HeyGen: Avatar IV
- Quali input e risultati sono disponibili?
POST /v1/videos·heygen/avatar-iv:text,image,audio,video→video- Quali campi usa la richiesta?
POST /v1/videos·heygen/avatar-iv:model,input_references,prompt