Source: https://ailoot.ai/models/it/heygen-heygen-video-1/
Canonical: https://ailoot.ai/models/it/heygen-heygen-video-1/
Language: it

# HeyGen: HeyGen Video

[Markdown](https://ailoot.ai/models/it/heygen-heygen-video-1/index.md) · [JSON](https://ailoot.ai/models/it/heygen-heygen-video-1/facts.json)

## [HeyGen: HeyGen Video](https://ailoot.ai/models/it/heygen-heygen-video-1/)

HeyGen Video genera scene di 5–15 secondi con dialoghi, ambiente sonoro ed effetti da testo, un’immagine iniziale o riferimenti visivi e audio. Il modello generalista heygen-video-1 supporta inquadrature di prodotti e personaggi, con controlli di riferimento e output MP4. Azioni chiare e circoscritte gli forniscono un brief di produzione utile.

- [**Ailoot Ultra · Video** `POST /v1/videos` `heygen/heygen-video-1`](https://ailoot.ai/models/it/heygen-heygen-video-1/#method-0)

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.

HeyGen Video è il modello generalista di HeyGen per generare scene, identificato dal produttore come heygen-video-1. Crea insieme soggetto, ambientazione, luce e suono da un brief creativo. Ogni clip dura 5–15 secondi e contiene la propria traccia audio generata, compresi dialoghi, ambiente sonoro ed effetti. Gli input utili alla produzione comprendono una descrizione di scena, una fotografia di prodotto o materiale che definisce una persona, un luogo o un movimento. Il risultato è una breve scena per una presentazione di prodotto, un inserto introduttivo, una vista immobiliare o altri lavori di montaggio video.

Tre modalità assegnano ruoli diversi agli input. La generazione da testo crea una scena dal prompt. Quella da immagini inizia letteralmente dall’immagine fornita, poi segue il brief per l’azione. Quella da riferimenti usa immagini, video e audio facoltativo per guidare una scena composta ex novo; richiede almeno un’immagine o un video di riferimento. Scegli un’immagine di primo fotogramma quando la composizione iniziale deve corrispondere a un’immagine fissa, oppure riferimenti quando un oggetto noto deve comparire in una composizione diversa. Questo modello di scene è distinto dai motori di rendering di avatar di HeyGen e dal flusso di composizione Video Agent.

La guida del produttore privilegia indicazioni dettagliate e concrete per l’inquadratura: un soggetto, un luogo e un’azione circoscritta, con una camera ferma o in movimento delicato. Descrivi posizione della camera, obiettivo o intenzione di profondità di campo, luce, texture delle superfici e trattamento cromatico. Spiega dove gli oggetti si toccano quando un’azione dipende dal contatto. Per un esempio di prodotto, usa una fotografia di riferimento di una borraccia da viaggio e chiedi che sia su un bancone di legno mentre un presentatore parla accanto, con un piccolo movimento di camera verso la borraccia. Controllane forma, posizione e segni visibili nel risultato.

Gli elenchi di riferimenti supportano fino a nove immagini, tre video e tre elementi audio, con un massimo di dodici riferimenti in totale. Immagini, video e audio vengono numerati separatamente nel formato del prompt del produttore: la prima immagine è \<Picture 1\> e il primo video è \<Video 1\>. Assegna a ogni riferimento un ruolo e identificalo esplicitamente nel brief. Il modello legge i primi cinque secondi di ogni video di riferimento, quindi prepara la sezione pertinente all’inizio. Il riferimento API specifica inoltre proporzioni dei video di riferimento tra 1:4 e 4:1. Un clip lungo che contiene il movimento desiderato soltanto alla fine è una preparazione inadeguata per quella finestra di ingresso di cinque secondi.

L’interfaccia di riferimenti documentata accetta una risorsa HTTPS direttamente accessibile, un identificatore di risorsa caricata o dati base64 incorporati. La guida elenca dimensioni massime delle immagini di 16 MB tramite URL e 5 MB incorporati; video o audio possono raggiungere 32 MB tramite URL e 16 MB incorporati. Prepara materiale sorgente leggibile, con il soggetto importante facile da distinguere e senza istruzioni concorrenti nei diversi riferimenti. Mantieni l’orientamento previsto nell’immagine iniziale. Questi dettagli di ingresso riguardano il flusso di riferimenti del produttore e aiutano a organizzare i materiali creativi per la modalità selezionata.

Dirigi il suono nello stesso brief delle immagini. Specifica dialogo, interpretazione vocale, tono ambientale della stanza ed effetti precisi, compreso se un suono debba essere vicino o distante. Specifica il trattamento musicale previsto quando la scena deve contenere soltanto parlato e ambiente sonoro. La guida suggerisce circa 2,5 parole pronunciate al secondo come stima di pianificazione, quindi lascia spazio alle pause e all’azione visibile. Una breve introduzione può essere progettata come una battuta seguita da un momento che rivela il prodotto. Ascolta le parole effettive e verifica che il suono generato si adatti allo spazio e all’azione.

La durata di output si seleziona in secondi interi da cinque a quindici, con cinque secondi come valore predefinito. La risoluzione è una classe dimensionale: 480p, 768p, 1080p o 2k. Le scelte documentate di inquadratura sono 21:9, 16:9, 4:3, 1:1, 3:4 e 9:16. Per la generazione da testo e riferimenti a 1080p o 2k, seleziona 16:9 o 9:16; l’inquadratura adattiva da riferimenti è documentata a 480p e 768p. La generazione da immagini segue le proporzioni della prima immagine, quindi ritaglia prima della generazione quando cambia il formato richiesto. Controlla le dimensioni effettive del risultato completato invece di presumere che l’etichetta di una classe dimensionale implichi una coppia convenzionale di dimensioni in pixel.

La guida del modello specifica video MP4 con codifica delle immagini H.264 e audio AAC a 32 kHz stereo. Una generazione viene elaborata in modo asincrono e il lavoro completato fornisce indirizzo del video riproducibile, durata e dimensioni. L’indirizzo firmato del video può essere aggiornato recuperando di nuovo il lavoro. Conserva il clip effettivo, i materiali di riferimento e il brief per il controllo del montaggio. Una registrazione in attesa o in elaborazione segue la generazione; il video completato è il risultato di produzione da valutare per immagini, parlato e suono.

Il produttore documenta le scelte di miglioramento del prompt turbo, quality e disabled; disabled mantiene la formulazione preparata così com’è. Un seed fisso è utile per confrontare una modifica a una proposizione mantenendo gli altri input. Registra seed e impostazioni scelti insieme al brief dell’inquadratura. Per le scritte sullo schermo, mantieni breve la frase desiderata e scrivila con precisione; la guida consiglia di aggiungere successivamente in compositing paragrafi, caratteri piccoli e diagrammi annotati. Controlla ogni carattere visibile in un titolo generato invece di presumere che il testo sia stato riprodotto correttamente.

La guida identifica testi lunghi sullo schermo, movimenti organici morbidi come quelli di petali, carta o capelli e manipolazioni delle mani ravvicinate come aree meno affidabili. Per una spiegazione procedurale, lascia che una battuta scritta chiaramente comunichi i passaggi mentre l’immagine mostra una persona o un oggetto stabile; usa visual verificati separatamente quando l’operazione fisica stessa deve essere esatta. Controlla l’intera inquadratura per continuità degli oggetti, contatti, dettagli del volto e delle mani, dialogo e suono. Un elenco conciso di ciò che deve cambiare nella ripresa successiva mantiene pratico un brief di produzione dettagliato.

**Ailoot Ultra · Video** `POST /v1/videos` `heygen/heygen-video-1`

[`heygen/heygen-video-1`](https://ailoot.ai/models/it/#m=heygen%2Fheygen-video-1&route=Ultra&caller=heygen%2Fheygen-video-1&fmt=videos)

HeyGen /`heygen/heygen-video-1`

### Introduzione

HeyGen Video genera scene di 5–15 secondi con dialoghi, ambiente sonoro ed effetti da testo, un’immagine iniziale o riferimenti visivi e audio. Il modello generalista heygen-video-1 supporta inquadrature di prodotti e personaggi, con controlli di riferimento e output MP4. Azioni chiare e circoscritte gli forniscono un brief di produzione utile.

Input accettati

Testo · Immagini · Audio · Video

Risultati

Video

### Disponibile in Ailoot · input e metodi

**Ailoot Ultra · Video** `POST /v1/videos`

Tipi di input

`text`, `image`, `audio`, `video`

Tipi di output

`video`

Formato di output

byte MP4 originali; nessuna normalizzazione o transcodifica

| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
| --- | --- | --- | --- | --- |
| Campo`model` | Tipo`string` | RequisitoObbligatorio | Valori e limiti heygen/heygen-video-1 | Predefinito— |
| Campo`prompt` | Tipo`string` | RequisitoObbligatorio | Valori e limiti | Predefinito— |
| Campo`duration` | Tipo`integer` | RequisitoObbligatorio | Valori e limiti 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimo: 1 Massimo: 600 | Predefinito— |
| Campo`resolution` | Tipo`string` | RequisitoFacoltativo | Valori e limiti 480p, 768p, 2K | Predefinito— |
| Campo`aspect_ratio` | Tipo`string` | RequisitoFacoltativo | Valori e limiti 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Predefinito— |
| Campo`generate_audio` | Tipo`boolean` | RequisitoFacoltativo | Valori e limiti false | Predefinito— |
| Campo`frame_images` | Tipo`array` | RequisitoFacoltativo | Valori e limiti Numero minimo di elementi: 1 Numero massimo di elementi: 1 Contenuto in input: Array di oggetti fotogramma. Ogni oggetto contiene type=image\_url, image\_url con url e frame\_type. Usa un URL HTTPS dell'immagine e imposta frame\_type su first\_frame. Ogni ruolo del fotogramma compare al massimo una volta. Chiavi esatte: type, image\_url, frame\_type Condizioni: Queste chiavi descrivono ogni oggetto fotogramma; image\_url contiene solo url. Ometti frame\_images per una richiesta di solo testo. | Predefinito— |
| Campo`input_references` | Tipo`array` | RequisitoFacoltativo | Valori e limiti | Predefinito— |
| Campo`seed` | Tipo`integer` | RequisitoFacoltativo | Valori e limiti Minimo: -9.223.372.036.854.775.808 Massimo: 9.223.372.036.854.775.807 | Predefinito— |
| Campo`callback_url` | Tipo`string` | RequisitoFacoltativo | Valori e limiti Schema: ^https:// | Predefinito— |
| Campo`session_id` | Tipo`string` | RequisitoFacoltativo | Valori e limiti | Predefinito— |
| Campo`trace` | Tipo`object` | RequisitoFacoltativo | Valori e limiti | Predefinito— |
| Campo`user` | Tipo`string` | RequisitoFacoltativo | Valori e limiti | Predefinito— |

Combinazioni di materiali in input

**Da testo a video** · Un prompt scritto. · Obbligatorio: model, prompt, duration

`Fornisci il prompt come testo e la durata in secondi interi. Scegli una risoluzione supportata e, se necessario, un rapporto d'aspetto.`

`model`: Tipo: string · heygen/heygen-video-1

`prompt`: Tipo: string · Numero massimo di byte UTF-8: 10.000 · Sono richiesti caratteri diversi dagli spazi: Sì

**Da immagine a video** · Un prompt scritto e un'immagine del primo fotogramma. · Obbligatorio: model, prompt, duration, frame\_images

`frame_images è un array. Ogni oggetto fotogramma contiene type, image_url e frame_type; image_url contiene url. Imposta type su image_url. Usa first_frame. Ogni ruolo del fotogramma può comparire al massimo una volta. Fornisci un URL HTTPS pubblico dell'immagine per ogni fotogramma. Scegli una risoluzione supportata e, se necessario, un rapporto d'aspetto.`

Chiavi esatte: type, image\_url, frame\_type

`model`: Tipo: string · heygen/heygen-video-1

`prompt`: Tipo: string · Numero massimo di byte UTF-8: 10.000 · Sono richiesti caratteri diversi dagli spazi: Sì

**Reference to video** · Un prompt scritto e riferimenti a immagini, video e audio supportati. · Obbligatorio: model, prompt, duration, input\_references

`input_references è un array di oggetti. Imposta type su image_url, video_url, audio_url e usa il campo corrispondente contenente url. Usa URL HTTPS pubblici. Ometti frame_images per selezionare la modalità con riferimenti. Scegli una risoluzione supportata e, se necessario, un rapporto d'aspetto.`

`model`: Tipo: string · heygen/heygen-video-1

`prompt`: Tipo: string · Numero massimo di byte UTF-8: 10.000 · Sono richiesti caratteri diversi dagli spazi: Sì

Parametri e ciclo di vita del metodo

| Parametro | Contratto |
| --- | --- |
| Parametro`content_type` | Contrattoapplication/json |
| Parametro`required` | Contrattomodel, prompt, duration |
| Parametro`material_types` | Contrattotext, image, audio, video |
| Parametro`additional_properties` | Contrattofalse |
| Parametro`optional_controls` | Contrattoresolution, aspect\_ratio, generate\_audio, frame\_images, input\_references, seed, callback\_url, session\_id, trace, user |

Ciclo di vita: `submit_once_poll_original`

`GET /v1/videos/{public_id}`

`GET /v1/videos/{public_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 fatturazioneresolution: 2k | Costo Output · Prezzo del video · Stima solo a fini di confronto **$0.2** per secondo di video |
| ConfigurazionePrezzo del video | Listino delle tariffe— | Quantità prevista— | Unità di fatturazioneper secondo di video | Condizioni di fatturazioneresolution: 480p | Costo Output · Prezzo del video · Stima solo a fini di confronto **$0.04** per secondo di video |
| ConfigurazionePrezzo del video | Listino delle tariffe— | Quantità prevista— | Unità di fatturazioneper secondo di video | Condizioni di fatturazioneresolution: 768p | Costo Output · Prezzo del video · Stima solo a fini di confronto **$0.072** per secondo di video |
| ConfigurazionePrezzo del video | Listino delle tariffe— | Quantità prevista— | Unità di fatturazioneper secondo di video | Condizioni di fatturazionemodalità di generazione: reference; risoluzione: 2k | Costo Output · Prezzo del video · Stima solo a fini di confronto **$0.36** per secondo di video |
| ConfigurazionePrezzo del video | Listino delle tariffe— | Quantità prevista— | Unità di fatturazioneper secondo di video | Condizioni di fatturazionemodalità di generazione: reference; risoluzione: 480p | Costo Output · Prezzo del video · Stima solo a fini di confronto **$0.14** per secondo di video |
| ConfigurazionePrezzo del video | Listino delle tariffe— | Quantità prevista— | Unità di fatturazioneper secondo di video | Condizioni di fatturazionemodalità di generazione: reference; risoluzione: 768p | Costo Output · Prezzo del video · Stima solo a fini di confronto **$0.2** per secondo di video |
| Configurazioneimmagine di riferimento in ingresso | Listino delle tariffe— | Quantità prevista— | Unità di fatturazioneper immagine di riferimento in input | Condizioni di fatturazione— | Costo Input · immagine di riferimento in ingresso · Stima solo a fini di confronto **$0.08** per immagine di riferimento in input |
| 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.2** 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 →](https://ailoot.ai/docs/it/billing/reserve/)

#### Dettagli della tariffa di riferimento

I listini di riferimento del modello non modificano la selezione del metodo, i preventivi o gli addebiti. Gli addebiti attivi usano le tariffe del metodo Ailoot selezionato.

Riferimenti tariffari delle configurazioni video

#### Prezzi per configurazione

Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.

| Configurazione | Condizioni di fatturazione | Costo |
| --- | --- | --- |
| ConfigurazionePrezzo del video | Condizioni di fatturazioneresolution: 2k | Costo Output · Prezzo del video **$0.18** per secondo di video Riferimento di prezzo pubblicato per la configurazione mostrata. Gli addebiti finali seguono la configurazione effettivamente fatturata. |
| ConfigurazionePrezzo del video | Condizioni di fatturazioneresolution: 480p | Costo Output · Prezzo del video **$0.04** per secondo di video Riferimento di prezzo pubblicato per la configurazione mostrata. Gli addebiti finali seguono la configurazione effettivamente fatturata. |
| ConfigurazionePrezzo del video | Condizioni di fatturazioneresolution: 768p | Costo Output · Prezzo del video **$0.06** per secondo di video Riferimento di prezzo pubblicato per la configurazione mostrata. Gli addebiti finali seguono la configurazione effettivamente fatturata. |
| ConfigurazionePrezzo del video | Condizioni di fatturazionemodalità di generazione: reference; risoluzione: 2k | Costo Output · Prezzo del video **$0.36** per secondo di video Riferimento di prezzo pubblicato per la configurazione mostrata. Gli addebiti finali seguono la configurazione effettivamente fatturata. |
| ConfigurazionePrezzo del video | Condizioni di fatturazionemodalità di generazione: reference; risoluzione: 480p | Costo Output · Prezzo del video **$0.08** per secondo di video Riferimento di prezzo pubblicato per la configurazione mostrata. Gli addebiti finali seguono la configurazione effettivamente fatturata. |
| ConfigurazionePrezzo del video | Condizioni di fatturazionemodalità di generazione: reference; risoluzione: 768p | Costo Output · Prezzo del video **$0.12** per secondo di video Riferimento di prezzo pubblicato per la configurazione mostrata. Gli addebiti finali seguono la configurazione effettivamente fatturata. |

### Esempi di richieste

#### Ailoot Ultra · Video

curl · crea un video

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"heygen/heygen-video-1","prompt":"A serene mountain landscape at sunset","resolution":"480p"}', 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 result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
```

### Ricevi e salva i risultati

#### Ailoot Ultra · Video

URL firmati di contenuti di tua proprietà

- `GET /v1/videos/{public_id}`
- `GET /v1/videos/{public_id}/content`

##### Verifica lo stato dell’attività

GET stato dell’operazione originale

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
```

Altre letture di contenuto

Salva ogni output completato di tua proprietà

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
    urls.append((str(i),u))
for label,path in urls:
    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
    target=Path('owned-'+label+'.bin')
    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
```

##### Conserva tutti i risultati completati

Salva ogni video completato o file restituito; recupera ogni URL di risorsa effettivamente restituito.

Conserva ogni risultato effettivo di tua proprietà e i metadati misurati restituiti.

##### Se occorre verificare la risposta originale

503 result\_pending\_check + id originale + X-Should-Retry:false; non ripetere mai l'operazione originale

Campi della risposta

| Campo | Tipo | Significato |
| --- | --- | --- |
| Campo`index` | Tipointeger | SignificatoPosizione di questo video nell'elenco dei risultati, con indice a partire da zero. |
| Campo`content_url` | Tipostring | SignificatoURL HTTPS firmato per il download di questo video completato. |
| Campo`sha256` | Tipostring \| null | SignificatoDigest SHA-256 dei byte video originali; null se non disponibile. |
| Campo`size_bytes` | Tipointeger \| null | SignificatoDimensione del file video originale in byte; null se non disponibile. |
| Campo`duration_ms` | Tipointeger \| null | SignificatoDurata misurata del video in millisecondi; null se non disponibile. |
| Campo`width` | Tipointeger \| null | SignificatoLarghezza del video in pixel; null se non disponibile. |
| Campo`height` | Tipointeger \| null | SignificatoAltezza del video in pixel; null se non disponibile. |
| Campo`video_codec` | Tipostring \| null | SignificatoIdentificatore del codec video; null se non registrato. |
| Campo`has_audio` | Tipoboolean \| null | SignificatoIndica se il video contiene una traccia audio; null se non misurato. |
| Campo`audio_codec` | Tipostring \| null | SignificatoIdentificatore del codec audio; null quando non è registrato alcun identificatore. |

Errori e passaggi successivi

| Risposta | Condizione | Passaggio successivo |
| --- | --- | --- |
| Risposta404 · `not_found_error` | CondizioneL'accesso al video non è disponibile oppure questo ID video non è stato trovato. | Passaggio successivoVerifica l'accesso al video. Per un video esistente, usa l'ID pubblico originale e la stessa chiave API. |
| Risposta401 · `authentication_error` | CondizioneLa chiave API non corrisponde all'account autenticato. | Passaggio successivoVerifica la chiave API e l'accesso all'account prima dell'invio. |
| Risposta400 · `invalid_request_error` | CondizioneNon è stato possibile leggere la richiesta oppure l'indice di download non è valido. | Passaggio successivoCorreggi il corpo della richiesta. Per un download, scegli un indice di uscita restituito dall'attività originale. |
| Risposta422 · `price_unavailable` | CondizioneNon è possibile determinare il prezzo della configurazione video selezionata. | Passaggio successivoScegli una configurazione video supportata e completa le opzioni obbligatorie prima di inviare una richiesta corretta. |
| Risposta422 · `invalid_request_error` | CondizioneUn input video o l'attività originale di continuazione non è valido. | Passaggio successivoUsa input HTTPS validi. Per la continuazione, usa l'ID video pubblico del tuo originale completato con la stessa chiave API. |
| Risposta402 · `billing_error` | CondizioneIl saldo disponibile o i limiti non consentono di riservare l'importo. | Passaggio successivoControlla il saldo disponibile e i limiti prima di inviare una nuova richiesta. |
| Risposta503 · `server_error` | CondizioneLa verifica video, l’archiviazione o l’accesso al servizio sono temporaneamente indisponibili. | Passaggio successivoAttendi che il servizio sia disponibile. Se hai già un ID video, verifica quell'attività originale invece di creare un'altra generazione. |
| Risposta503 · `result_pending_check` | CondizioneIl risultato video originale e l'addebito devono essere verificati. | Passaggio successivoConserva l'ID video restituito e verifica quell'attività. Non inviare una richiesta di generazione sostitutiva mentre la verifica è in corso. |
| Risposta503 · `owned_result_unavailable` | CondizioneIl download del video esistente è temporaneamente indisponibile. | Passaggio successivoVerifica in seguito la stessa attività video e scarica il risultato esistente. Una nuova generazione crea un'operazione separata. |
| Risposta409 · `video_not_ready` | CondizioneIl contenuto video non è stato pubblicato. | Passaggio successivoVerifica lo stato dell'attività originale. Scarica dopo che segnala completed; se segnala failed, segui l'avviso di verifica dell'addebito. |

### Alias

#### Alias del modello

**Ailoot Ultra** [`heygen/heygen-video-1`](https://ailoot.ai/models/it/#m=heygen%2Fheygen-video-1&route=Ultra&caller=heygen%2Fheygen-video-1&fmt=videos)

#### Alias dei percorsi dei metodi

Usa i percorsi dei metodi indicati sopra.

#### ID di chiamata correlati

[`heygen/heygen-video-1`](https://ailoot.ai/models/it/#m=heygen%2Fheygen-video-1&route=Ultra&caller=heygen%2Fheygen-video-1&fmt=videos)

FAQ · HeyGen: HeyGen Video

Quali input e risultati sono disponibili?

`POST /v1/videos` · `heygen/heygen-video-1`: `text`, `image`, `audio`, `video` → `video`

Quali campi usa la richiesta?

`POST /v1/videos` · `heygen/heygen-video-1`: `model`, `prompt`, `duration`, `resolution`, `aspect_ratio`, `generate_audio`, `frame_images`, `input_references`, `seed`, `callback_url`, `session_id`, `trace`, `user`

Quali limiti si applicano?

`POST /v1/videos` · `heygen/heygen-video-1`: `duration.minimum`: `1`; `duration.maximum`: `600`; `frame_images.max_items`: `1`; `frame_images.min_items`: `1`; `seed.minimum`: `-9223372036854775808`; `seed.maximum`: `9223372036854775807`

Collega Ailoot a Claude Code, OpenCode, Hermes o alla tua applicazione.

## L’azienda e il suo portafoglio di progetti

L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese.

## Acquista token con uno sconto.

Sconto con abbonamento per lavoro regolare. Codici fino al 50% sull’acquisto di token.

Abbonamento

Scegli un piano scontato per richieste regolari.

Codice fino al 50%

Inserisci il codice all’acquisto. Il prezzo si aggiorna secondo la promozione.

Spese nella cronologia

Modello, token e importo sono salvati per ogni richiesta.

[Scegli abbonamento](https://ailoot.ai/docs/it/billing/subscriptions/) · [Consulta prezzi dei modelli](https://ailoot.ai/models/it/)

## Collega l’API al prodotto che vendi.

SaaS, app e bot secondo offerta e accordo di licenza Ailoot. Per rivendere, richiedi una licenza reseller.

Applicazione commerciale

Integra generazione di testo, immagini, video e suono nelle funzioni a pagamento.

Licenza reseller

Invia descrizione del progetto e schema di accesso. Richiedi condizioni scritte per uso e rivendita.

Documenti sul sito

Offerta, accordo di licenza e politica sui dati sono disponibili prima della connessione.

[Richiedi licenza reseller](mailto:support@ailoot.ai) · [Offerta e accordo di licenza](https://ailoot.ai/legal/offer?lang=it)

## Ailoot · L’azienda e il suo portafoglio di progetti





Ailoot si basa su un’esperienza operativa consolidata, un’ampia base di clienti, un servizio stabile e un controllo costante dei KPI.





L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese.





Ailoot mette questa esperienza operativa al servizio dell’accesso API alle funzioni AI nei prodotti dei clienti, negli agenti, nelle applicazioni e nelle automazioni.