![]()
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.
| Data | Cosa è successo |
|---|---|
| 17 novembre 2026 | HeyGen pubblica il report tecnico di Avatar 6 |
| 19 novembre 2026 | Entrambi 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
| Voce | heygen-avatar-6 | heygen-avatar-6-turbo |
|---|---|---|
| Livello HeyGen | Avatar 6 Quality | Avatar 6 Turbo |
| Endpoint di invio | POST https://api.poyo.ai/api/generate/submit | Uguale |
| Risultato | GET /api/generate/status/{task_id} o callback_url | Uguale |
| Modalità di input | Foto, video di riferimento, avatar pubblico | Le stesse tre |
| Output | Un MP4, 1080p (predefinito) o 2K | Uguale |
| Input vocale | Audio 2–60 s, oppure testo fino a 1,000 caratteri (solo avatar pubblico) | Uguale |
| Prezzo, 1080p | 20 crediti ($0.10) al secondo | 10 crediti ($0.05) al secondo |
| Prezzo, 2K | 29 crediti ($0.145) al secondo | 18 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 quando | Input | Proporzioni |
|---|---|---|---|
| Avatar pubblico | avatar è presente | avatar + text (+ voice facoltativo), oppure avatar + audio_url | aspect_ratio: 16:9 (predefinito), 9:16, 1:1, 4:5, 5:4 |
| Video di riferimento | video_url è presente (e non c'è avatar) | video_url + audio_url, facoltativamente una foto in image_urls | Seguono il video di input |
| Foto | Predefinita | image_urls (esattamente una) + audio_url | Seguono 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
| Campo | Regola |
|---|---|
image_urls | Esattamente un URL; viene usato image_urls[0] |
video_url | Almeno 2 secondi, fino a 50 MB |
audio_url | 2–60 secondi, fino a 15 MB; il video dura quanto l'audio |
text | 1–1,000 caratteri (modalità avatar pubblico, al posto di audio_url) |
avatar | Uno di 1,248 nomi (156 persone); maiuscole/minuscole e spazi in eccesso ignorati |
voice | Uno di 102 nomi; predefinito Warm Pro Narrator |
prompt | Fino a 1,200 caratteri |
resolution | 1080p 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):
| Modello | 1080p al secondo | 2K al secondo | 10 s a 1080p | 60 s a 1080p |
|---|---|---|---|---|
heygen-avatar-6-turbo | 10 crediti ($0.05) | 18 crediti ($0.09) | 100 crediti ($0.50) | 600 crediti ($3.00) |
heygen-avatar-6 | 20 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.
| Modello | Avatar / voce | Script | Output | Costo ai prezzi attuali | Tempo reale |
|---|---|---|---|---|---|
heygen-avatar-6-turbo | Abigail Office Front / Jessica Anne Bogart | 27 parole, 16:9, 1080p | 10.16 s | 110 crediti (11 s × 10) | Circa 2.4 min |
heygen-avatar-6 | Bryan Tech Expert / Andrew | 21 parole, 16:9, 1080p | 6.88 s | 140 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 serve | Chiama |
|---|---|
| Un video con presentatore da uno script, senza file audio | heygen-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 2K | Modalità foto |
| Una mascotte o un personaggio cartoon che parla | Modalità video di riferimento |
| Bozze, anteprime, grandi volumi | heygen-avatar-6-turbo (vedi Avatar 6 vs Turbo) |
| Il prezzo al secondo più basso da foto più audio | Confronta con Kling Avatar 2.0 |
| Audio più lungo di 60 secondi | OmniHuman 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.