guides

HeyGen Avatar 6 API: cos'è HeyGen Avatar 6, ID modello, modalità di input, limiti e prezzo

Poyo.ai Team
9 min read
Share:

HeyGen Avatar 6 API su PoYo: ID modello, modalità di input, limiti e prezzo

La HeyGen Avatar 6 API è disponibile su PoYo con due ID modello: heygen-avatar-6 e il livello Turbo heygen-avatar-6-turbo, a metà del prezzo 1080p. Entrambi trasformano una foto, un video di riferimento di un personaggio animato o uno dei 1,248 look di avatar pubblici di HeyGen in un MP4 parlante con lip sync a 1080p o 2K, guidato dal tuo audio oppure, per gli avatar pubblici, da un testo. Puoi provare entrambi i livelli nella pagina del modello HeyGen Avatar 6 prima di scrivere codice.

Questa panoramica spiega cosa ha rilasciato HeyGen, il formato della richiesta su PoYo, i limiti che il tuo codice deve validare, il prezzo al secondo e cosa abbiamo misurato il giorno del lancio.

Cos'è HeyGen Avatar 6?

HeyGen Avatar 6 è il modello video di avatar parlanti di HeyGen. Il report tecnico di HeyGen, datato 17 novembre 2026, afferma che "Avatar 6 riproduce come una persona appare, parla e si muove, fino al 2K" e che funziona "a partire da una sola foto". HeyGen descrive due livelli, Avatar 6 Quality e Avatar 6 Turbo; su PoYo sono heygen-avatar-6 e heygen-avatar-6-turbo.

DataCosa è successo
17 novembre 2026HeyGen pubblica il report tecnico di Avatar 6
19 novembre 2026Entrambi i livelli richiamabili su PoYo come heygen-avatar-6 e heygen-avatar-6-turbo

Tre affermazioni di HeyGen contano per un'integrazione, perché corrispondono a campi della richiesta:

  • 2K nativo. HeyGen dice che "ogni fotogramma [è] generato a 2880×1620". Su PoYo lo scegli con "resolution": "2K".
  • Prompt di movimento. Il report di HeyGen dice: "Scrivi l'azione accanto alle parole. Avatar 6 la esegue esattamente al momento giusto." Su PoYo è il campo prompt, fino a 1,200 caratteri.
  • Preferenza rispetto ad Avatar V. Nel voto online di HeyGen, il 69.7% di 879 voti ha preferito Avatar 6 Quality ad Avatar V, e il 64.3% di 863 voti ha preferito Avatar 6 Turbo ad Avatar V Turbo. Sono numeri di HeyGen stessa.

HeyGen Avatar 6 API in sintesi

Voceheygen-avatar-6heygen-avatar-6-turbo
Livello HeyGenAvatar 6 QualityAvatar 6 Turbo
Endpoint di invioPOST https://api.poyo.ai/api/generate/submitUguale
RisultatoGET /api/generate/status/{task_id} o callback_urlUguale
Modalità di inputFoto, video di riferimento, avatar pubblicoLe stesse tre
OutputUn MP4, 1080p (predefinito) o 2KUguale
Input vocaleAudio 2–60 s, oppure testo fino a 1,000 caratteri (solo avatar pubblico)Uguale
Prezzo, 1080p20 crediti ($0.10) al secondo10 crediti ($0.05) al secondo
Prezzo, 2K29 crediti ($0.145) al secondo18 crediti ($0.09) al secondo

I campi della richiesta sono identici, quindi cambiare livello significa cambiare solo la stringa model. Le regole dei campi sono nella documentazione PoYo di HeyGen Avatar 6.

Tre modalità di input, un solo endpoint

Non esiste un campo mode. Sono gli input che invii a scegliere la modalità, in quest'ordine:

ModalitàSelezionata quandoInputProporzioni
Avatar pubblicoavatar è presenteavatar + text (+ voice facoltativo), oppure avatar + audio_urlaspect_ratio: 16:9 (predefinito), 9:16, 1:1, 4:5, 5:4
Video di riferimentovideo_url è presente (e non c'è avatar)video_url + audio_url, facoltativamente una foto in image_urlsSeguono il video di input
FotoPredefinitaimage_urls (esattamente una) + audio_urlSeguono la foto di input

prompt e resolution funzionano in ogni modalità. aspect_ratio e voice appartengono solo alla modalità avatar pubblico. Invia gli input di una sola modalità per richiesta. La documentazione per sviluppatori di HeyGen divide questo lavoro tra due API separate (un'API di modello per immagine o video più audio, e un'API applicativa per i look di avatar HeyGen); su PoYo è un'unica forma di richiesta per entrambi.

La modalità video di riferimento è pensata per personaggi animati o illustrati. Per una persona reale, usa la modalità foto con una foto.

Limiti da validare prima dell'invio

CampoRegola
image_urlsEsattamente un URL; viene usato image_urls[0]
video_urlAlmeno 2 secondi, fino a 50 MB
audio_url2–60 secondi, fino a 15 MB; il video dura quanto l'audio
text1–1,000 caratteri (modalità avatar pubblico, al posto di audio_url)
avatarUno di 1,248 nomi (156 persone); maiuscole/minuscole e spazi in eccesso ignorati
voiceUno di 102 nomi; predefinito Warm Pro Narrator
promptFino a 1,200 caratteri
resolution1080p o 2K

Tutti gli URL dei media devono essere pubblici e scaricabili direttamente via HTTP o HTTPS. PoYo controlla la durata dell'audio, la durata del video di riferimento e il nome dell'avatar al momento dell'invio, quindi gli input errati falliscono subito invece che dopo un'attesa. L'output può essere circa un decimo di secondo più corto dell'audio. Ogni nome di avatar e di voce è in Avatars and Voices, con un catalogo JSON scaricabile.

Prezzi della HeyGen Avatar 6 API su PoYo

PoYo fattura per secondo di output in crediti (1 credito = $0.005):

Modello1080p al secondo2K al secondo10 s a 1080p60 s a 1080p
heygen-avatar-6-turbo10 crediti ($0.05)18 crediti ($0.09)100 crediti ($0.50)600 crediti ($3.00)
heygen-avatar-620 crediti ($0.10)29 crediti ($0.145)200 crediti ($1.00)1,200 crediti ($6.00)

I secondi fatturati sono arrotondati per eccesso al secondo intero. Con audio_url, l'addebito segue la durata dell'audio e avviene all'invio. Con text, PoYo riserva i crediti all'invio e li conguaglia sulla durata del video finito quando il task termina. Il dettaglio completo, con esempi svolti, è in Prezzi della HeyGen Avatar 6 API.

Risultati dei test del giorno del lancio

Il team PoYo li ha eseguiti sull'API di produzione il 19 novembre 2026, in modalità avatar pubblico con testo. Il tempo reale va dall'invio al risultato come visto da un client in polling, quindi consideralo approssimativo.

ModelloAvatar / voceScriptOutputCosto ai prezzi attualiTempo reale
heygen-avatar-6-turboAbigail Office Front / Jessica Anne Bogart27 parole, 16:9, 1080p10.16 s110 crediti (11 s × 10)Circa 2.4 min
heygen-avatar-6Bryan Tech Expert / Andrew21 parole, 16:9, 1080p6.88 s140 crediti (7 s × 20)Circa 2 min

Due minuti o più per una clip breve significano che si tratta di un'API asincrona: invia, conserva il task_id e fai polling o ricevi una callback. Non tenere aperta una richiesta HTTP rivolta all'utente mentre il task è in esecuzione.

HeyGen Avatar 6 API: avvio rapido

Questo è l'esempio della documentazione per la modalità avatar pubblico con testo:

curl https://api.poyo.ai/api/generate/submit \
  -H "Authorization: Bearer $POYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "heygen-avatar-6-turbo",
    "input": {
      "avatar": "Abigail Office Front",
      "text": "Hello and welcome to this demonstration of HeyGen Avatar 6.",
      "voice": "Warm Pro Narrator",
      "prompt": "Speak with calm confidence and nod slightly at the end.",
      "aspect_ratio": "16:9",
      "resolution": "1080p"
    }
  }'

Controlla code nel body (deve essere 200), salva data.task_id, poi chiama GET https://api.poyo.ai/api/generate/status/{task_id} finché status non è finished e leggi l'MP4 da data.files[].file_url. I video generati restano disponibili per 3 giorni, quindi copiali nel tuo storage. La modalità foto, la modalità video di riferimento, un loop Python con limite di tempo e la gestione degli errori sono nella guida alla HeyGen Avatar 6 API.

Quali richieste affidare alla HeyGen Avatar 6 API

Ti serveChiama
Un video con presentatore da uno script, senza file audioheygen-avatar-6 o -turbo in modalità avatar pubblico (guida text-to-avatar)
La foto di una persona reale che pronuncia il tuo audio, 1080p o 2KModalità foto
Una mascotte o un personaggio cartoon che parlaModalità video di riferimento
Bozze, anteprime, grandi volumiheygen-avatar-6-turbo (vedi Avatar 6 vs Turbo)
Il prezzo al secondo più basso da foto più audioConfronta con Kling Avatar 2.0
Audio più lungo di 60 secondiOmniHuman 2.0 accetta 4–300 s di audio a 720p, 21 crediti al secondo

Domande frequenti

Quali sono gli ID modello della HeyGen Avatar 6 API?

heygen-avatar-6 (il livello Avatar 6 Quality di HeyGen) e heygen-avatar-6-turbo. Entrambi usano POST https://api.poyo.ai/api/generate/submit con gli stessi campi input.

Quanto costa la HeyGen Avatar 6 API?

Su PoYo, per secondo di output: Turbo 10 crediti ($0.05) a 1080p e 18 crediti ($0.09) a 2K; Avatar 6 20 crediti ($0.10) a 1080p e 29 crediti ($0.145) a 2K. I secondi sono arrotondati per eccesso.

La HeyGen Avatar 6 API può creare un video solo da testo?

Sì, in modalità avatar pubblico. Invia avatar e fino a 1,000 caratteri di text, più un voice facoltativo tra le 102 voci disponibili. Le modalità foto e video di riferimento richiedono audio_url.

Quanto può durare un video della HeyGen Avatar 6 API?

Con l'audio, 2–60 secondi, pari alla durata dell'audio. Con il testo, il video dura quanto l'avatar impiega a leggere fino a 1,000 caratteri.

Quali risoluzioni supporta la HeyGen Avatar 6 API?

1080p (predefinita) e 2K. La modalità avatar pubblico aggiunge aspect_ratio (16:9, 9:16, 1:1, 4:5, 5:4); le altre modalità mantengono le proporzioni dell'input.

La HeyGen Avatar 6 API supporta i webhook?

Sì. Aggiungi un callback_url di primo livello e PoYo invia il risultato del task quando è finished o failed. Puoi anche fare polling dell'endpoint di stato.

Share: