Source: https://ailoot.ai/models/it/minimax-hailuo-2-3/
Canonical: https://ailoot.ai/models/it/minimax-hailuo-2-3/
Language: it

# MiniMax-Hailuo-2.3

[Markdown](https://ailoot.ai/models/it/minimax-hailuo-2-3/index.md) · [JSON](https://ailoot.ai/models/it/minimax-hailuo-2-3/facts.json)

## [MiniMax-Hailuo-2.3](https://ailoot.ai/models/it/minimax-hailuo-2-3/)

MiniMax Hailuo 2.3 crea video da testo o da un’immagine iniziale, con controlli per movimento e direzione della camera. Scegli sei secondi a 768P o 1080P oppure dieci secondi a 768P per recitazioni di personaggi, scene stilizzate e inquadrature di prodotti da controllare e montare.

- [**Ailoot · Generazione video** `POST /v1/videos/generations` `MiniMax-Hailuo-2.3`](https://ailoot.ai/models/it/minimax-hailuo-2-3/#method-0)
- [**Ailoot Ultra · Video** `POST /v1/videos` `MiniMax-Hailuo-2.3`](https://ailoot.ai/models/it/minimax-hailuo-2-3/#method-1)

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.

MiniMax Hailuo 2.3 è un modello di generazione video con modalità da testo e da immagini. Sviluppa Hailuo 02 concentrandosi su azione fisica, stile visivo, microespressioni dei personaggi e risposta alle istruzioni di movimento. Fornisci una scena scritta per creare un’inquadratura da zero oppure usa un’immagine iniziale per definire la vista di apertura e descrivere il movimento successivo.

La recitazione fisica è una delle principali aree di miglioramento dell’edizione. Hailuo 2.3 mira a rendere i movimenti del corpo più fluidi e controllati, comprese le scene con camera in movimento. Pianifica l’azione importante prima di aggiungere dettagli decorativi. Un personaggio che solleva un oggetto, si gira verso un’altra persona o attraversa una stanza dà all’inquadratura un evento visibile da valutare. Decidi quale movimento porta avanti la storia e mantieni coerenti con esso le istruzioni circostanti.

La stilizzazione è un’altra priorità. Il modello supporta lavori in stile anime e illustrazione, oltre a stili come la pittura a inchiostro diluito e la computer grafica dei videogiochi. Descrivi il trattamento visivo desiderato e mantieni l’aspetto coerente con la scena. Se un’immagine iniziale definisce già uno stile di disegno, usa il testo per guidare l’animazione invece di introdurre una descrizione concorrente del design del personaggio. Controlla l’intera clip per verificare che quel trattamento resti leggibile durante il movimento.

Il modello si concentra anche sulla recitazione del volto e sui cambiamenti sottili di espressione. Prepara un’inquadratura di personaggio intorno alla reazione importante: notare un oggetto, incuriosirsi o rispondere con un piccolo sorriso. Una vista ravvicinata può rendere il cambiamento più facile da valutare, mentre una lunga sequenza di gesti può distrarre da esso. Controlla il volto prima, durante e dopo la reazione invece di giudicare soltanto un fotogramma rappresentativo.

Il movimento degli oggetti è utile per scene incentrate sui prodotti. Un brief può mostrare un piccolo vaso di ceramica che ruota in una calda luce laterale mentre la camera si avvicina gradualmente. Identifica quali proprietà devono restare riconoscibili, come sagoma, bordo e finitura superficiale. Controlla quei dettagli durante il movimento, perché un’atmosfera convincente da sola non dimostra una vista fedele del prodotto.

Per la generazione da testo, la descrizione obbligatoria può contenere fino a 2.000 caratteri. Indica soggetto, azione, ambientazione e stile visivo in un ordine coerente. La generazione da immagini richiede un’immagine del primo fotogramma, con una descrizione facoltativa fino a 2.000 caratteri. L’immagine fissa la composizione iniziale, quindi prepara soggetto e inquadratura prima di richiedere il movimento. Lascia spazio visibile dove devono muoversi un braccio, un oggetto o un personaggio.

L’immagine iniziale accetta JPG, JPEG, PNG o WebP, deve essere inferiore a 20 MB, avere un lato corto maggiore di 300 pixel e un rapporto d’aspetto tra 2:5 e 5:2. Può essere fornita come URL pubblico di immagine o URL di dati Base64. Scegli un’immagine iniziale chiara invece di affidarti all’animazione per correggere un volto nascosto o un’azione già ritagliata.

Hailuo 2.3 genera a 24 fotogrammi al secondo. Un’inquadratura di sei secondi può usare 768P o 1080P; una di dieci secondi usa 768P. I valori predefiniti sono sei secondi e 768P. Scegli la durata per l’azione che vuoi vedere: una breve reazione può adattarsi a una ripresa corta, mentre un movimento più lento richiede più spazio. Leggi larghezza e altezza effettive del risultato completato quando inserisci la clip in un montaggio, poiché l’etichetta di risoluzione da sola non definisce tutta l’inquadratura.

La direzione della camera può usare comandi tra parentesi quadre. I controlli disponibili comprendono carrellata laterale, panoramica orizzontale, avanzamento, movimento verticale della camera, panoramica verticale, zoom, scuotimento, inseguimento e inquadratura statica. Un comando come \[Push in\] dirige l’avvicinamento; i comandi raggruppati nelle stesse parentesi agiscono insieme, mentre quelli disposti in ordine descrivono una sequenza. MiniMax consiglia al massimo tre comandi simultanei. Mantieni il movimento di camera compatibile con l’azione del soggetto, così l’evento principale resta facile da seguire.

L’ottimizzazione automatica del prompt è attivata per impostazione predefinita e può essere disattivata per controllare più da vicino la formulazione fornita. La preelaborazione rapida facoltativa riduce il tempo di ottimizzazione quando questa è attivata; è un’impostazione separata dalla scelta del modello Hailuo 2.3 Fast. Hailuo 2.3 standard supporta entrambe le modalità di creazione, mentre Fast è l’edizione distinta di generazione da immagini. Scegli l’edizione in base al fatto che il progetto inizi con solo testo o con un fotogramma esistente.

Il flusso di generazione restituisce un identificatore asincrono di attività, poi segnala preparazione, accodamento, elaborazione, successo o errore. In caso di successo, il risultato fornisce un identificatore di file e le dimensioni effettive del video, e il video completato viene recuperato per il download. Salva la clip mentre il suo indirizzo di download è valido. Il riferimento attuale del produttore per il download video assegna all’URL restituito una durata di un’ora. Per una sequenza montata, conserva ogni inquadratura con prompt e immagine iniziale, così la direzione creativa scelta resta tracciabile durante le revisioni.

Controlla azione, continuità fisica, dettagli del volto o del prodotto, stile visivo e comportamento della camera nella clip salvata. Guarda l’intera inquadratura, poi esamina inizio e fine dove si unirà ad altro materiale. Se la richiesta contiene troppi movimenti concorrenti, semplifica l’azione principale; se il design iniziale è poco chiaro, migliora l’immagine di partenza. Seleziona un’inquadratura che comunichi l’evento previsto, poi aggiungi narrazione, titoli e transizioni nel flusso di montaggio.

**Ailoot · Generazione video** `POST /v1/videos/generations` `MiniMax-Hailuo-2.3`

[`MiniMax-Hailuo-2.3`](https://ailoot.ai/models/it/#m=MiniMax-Hailuo-2.3&route=Core&caller=MiniMax-Hailuo-2.3&fmt=videos)

MiniMax /`MiniMax-Hailuo-2.3`

### Introduzione

MiniMax Hailuo 2.3 crea video da testo o da un’immagine iniziale, con controlli per movimento e direzione della camera. Scegli sei secondi a 768P o 1080P oppure dieci secondi a 768P per recitazioni di personaggi, scene stilizzate e inquadrature di prodotti da controllare e montare.

Input accettati

Testo · Immagini

Risultati

Video

### Disponibile in Ailoot · input e metodi

**Ailoot · Generazione video** `POST /v1/videos/generations`

Tipi di input

`text`, `image`

Tipi di output

`video`

Formato di output

mp4

| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
| --- | --- | --- | --- | --- |
| Campo`model` | Tipo`string` | RequisitoObbligatorio | Valori e limiti MiniMax-Hailuo-2.3 | Predefinito— |
| Campo`prompt` | Tipo`string` | RequisitoObbligatorio | Valori e limiti Lunghezza minima: 1 Lunghezza massima: 2000 Unità: caratteri Unicode | Predefinito— |
| Campo`duration` | Tipo`integer` | RequisitoFacoltativo | Valori e limiti 6, 10 Condizioni: 10 secondi richiedono 768P Unità: secondi | Predefinito6 |
| Campo`resolution` | Tipo`string` | RequisitoFacoltativo | Valori e limiti 768P, 1080P Condizioni: 1080P richiede 6 secondi | Predefinito768P |
| Campo`first_frame_image` | Tipo`https_url\|data_image_url` | RequisitoFacoltativo | Valori e limiti Numero massimo di byte decodificati: 20.971.520 Tipi MIME: image/jpeg, image/png, image/webp Dimensione minima (esclusa): 300 Intervallo dei rapporti d’aspetto: 2:5, 5:2 | Predefinito— |
| Campo`prompt_optimizer` | Tipo`boolean` | RequisitoFacoltativo | Valori e limiti | Predefinito— |
| Campo`fast_pretreatment` | Tipo`boolean` | RequisitoFacoltativo | Valori e limiti | Predefinito— |

Combinazioni di materiali in input

**Da immagine a video** · Obbligatorio: prompt, first\_frame\_image

**Da testo a video** · Obbligatorio: prompt

Parametri e ciclo di vita del metodo

| Parametro | Contratto |
| --- | --- |
| Parametro`material_types` | Contrattotext, image |
| Parametro`required` | Contrattonull |
| Parametro`optional_controls` | Contrattonull |

Ciclo di vita: `submit_once_poll_original`

`GET /v1/videos/{request_id}`

`GET /v1/videos/generations/{request_id}`

`GET /v1/videos/{request_id}/content`

`GET /v1/videos/generations/{request_id}/content`

Le strutture dei metodi e gli ID sono esatti; la capacità del fornitore è distinta dall’ammissione delle richieste.

### Tariffe

#### Tariffe dei metodi Ailoot

Output

0,28 USD *per video di 6 s a 768p*

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.

MiniMax-Hailuo-2.3

#### Prezzi per configurazione

| Configurazione | Condizioni di fatturazione | Costo |
| --- | --- | --- |
| ConfigurazioneMiniMax-Hailuo-2.3 · Configurazione predefinita | Condizioni di fatturazioneConfigurazione predefinita | Costo Input · Input **0,00 USD** per chiamata Output · Output **0,60 USD** per chiamata |

MiniMax-Hailuo-2.3

#### Prezzi per configurazione

| Configurazione | Condizioni di fatturazione | Costo |
| --- | --- | --- |
| ConfigurazioneMiniMax-Hailuo-2.3 · Configurazione predefinita | Condizioni di fatturazioneConfigurazione predefinita | Costo Input · Input **0,00 USD** per chiamata Output · Output **1,20 USD** per chiamata |

MiniMax-Hailuo-2.3

#### Prezzi per configurazione

| Configurazione | Condizioni di fatturazione | Costo |
| --- | --- | --- |
| ConfigurazioneMiniMax-Hailuo-2.3 · Configurazione predefinita | Condizioni di fatturazioneConfigurazione predefinita | Costo Input · Input **0,00 USD** per chiamata Output · Output **1,20 USD** per chiamata |

### Esempi di richieste

#### Ailoot · Generazione video

Esempio video

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl https://api.ailoot.ai/v1/videos/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "MiniMax-Hailuo-2.3", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side.", "duration": 6, "resolution": "768P"}'
```

### Ricevi e salva i risultati

#### Ailoot · Generazione video

mp4

- `GET /v1/videos/{request_id}`
- `GET /v1/videos/generations/{request_id}`
- `GET /v1/videos/{request_id}/content`
- `GET /v1/videos/generations/{request_id}/content`

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

GET stato

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id" \
  -H "Authorization: Bearer $AILOOT_API_KEY"
```

Altre letture di contenuto

GET contenuto

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  --output video.mp4
```

##### Conserva tutti i risultati completati

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

Conserva ogni elemento di dati e indice di uscita restituito. content\_url indica solo il primo; recupera ogni percorso del contenuto o risorsa effettiva. GET del contenuto senza index non restituisce tutti i risultati.

##### Se occorre verificare la risposta originale

Consulta l'attività originale esistente; non ripetere mai un invio dall'esito sconosciuto.

Campi della risposta

| Campo | Tipo |
| --- | --- |
| Campo`id` | Tipostring |
| Campo`object` | Tipostring |
| Campo`model` | Tipostring |
| Campo`status` | Tipostring |
| Campo`content_url` | Tiposigned URL |
| Campo`data[]` | Tiposigned URL |
| Campo`usage` | Tipoobject |
| Campo`result_pending_check` | Tipoboolean |

Errori e passaggi successivi

| Risposta | Condizione | Passaggio successivo |
| --- | --- | --- |
| Risposta400 · `invalid_request_error` | CondizioneCampi obbligatori, rappresentazione del materiale o valore del parametro non validi | Passaggio successivoCorreggi i campi indicati prima di una nuova richiesta di creazione. |
| Risposta409 · `video_not_ready` | CondizioneContenuto del risultato originale non ancora disponibile | Passaggio successivoInterroga periodicamente l'ID originale restituito e rispetta Retry-After. |
| Risposta`server_error` | CondizioneLa risposta restituita indica che l'operazione o il risultato richiede una verifica | Passaggio successivoConserva l'ID originale di operazione/task restituito, gli header della richiesta e la risposta; continua a leggere l'operazione originale tramite le modalità supportate. Non reinviare la richiesta di creazione. |

### Alias

#### Alias del modello

<strong>Ailoot</strong> [`MiniMax-Hailuo-2.3`](https://ailoot.ai/models/it/#m=MiniMax-Hailuo-2.3&route=Core&caller=MiniMax-Hailuo-2.3&fmt=videos)
**Ailoot Ultra** [`MiniMax-Hailuo-2.3`](https://ailoot.ai/models/it/#m=MiniMax-Hailuo-2.3&route=Ultra&caller=MiniMax-Hailuo-2.3&fmt=videos)

#### Alias dei percorsi dei metodi

`/v1/videos/generations`, `/videos`, `/videos/generations`

#### ID di chiamata correlati

[`MiniMax-Hailuo-2.3`](https://ailoot.ai/models/it/#m=MiniMax-Hailuo-2.3&route=Core&caller=MiniMax-Hailuo-2.3&fmt=videos), [`MiniMax-Hailuo-2.3`](https://ailoot.ai/models/it/#m=MiniMax-Hailuo-2.3&route=Ultra&caller=MiniMax-Hailuo-2.3&fmt=videos)

**Ailoot Ultra · Video** `POST /v1/videos` `MiniMax-Hailuo-2.3`

[`MiniMax-Hailuo-2.3`](https://ailoot.ai/models/it/#m=MiniMax-Hailuo-2.3&route=Ultra&caller=MiniMax-Hailuo-2.3&fmt=videos)

MiniMax /`MiniMax-Hailuo-2.3`

### Introduzione

MiniMax Hailuo 2.3 crea video da testo o da un’immagine iniziale, con controlli per movimento e direzione della camera. Scegli sei secondi a 768P o 1080P oppure dieci secondi a 768P per recitazioni di personaggi, scene stilizzate e inquadrature di prodotti da controllare e montare.

Input accettati

Testo

Risultati

Video

### Disponibile in Ailoot · input e metodi

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

Tipi di input

`text`

Tipi di output

`video`

Formato di output

mp4

Numero di output

Fino a 1 output

| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
| --- | --- | --- | --- | --- |
| Campo`model` | Tipo`string` | RequisitoObbligatorio | Valori e limiti MiniMax-Hailuo-2.3 | Predefinito— |
| Campo`prompt` | Tipo`string` | RequisitoObbligatorio | Valori e limiti Lunghezza minima: 1 Lunghezza massima: 2000 Condizioni: Per 768P: al massimo 2000 punti di codice Unicode. Per 1080P: meno di 200 punti di codice Unicode (massimo 199). Il prompt deve contenere testo diverso da soli spazi bianchi. Unità: caratteri Unicode | Predefinito— |
| Campo`duration` | Tipo`integer` | RequisitoObbligatorio | Valori e limiti 6 Unità: secondi | Predefinito— |
| Campo`resolution` | Tipo`string` | RequisitoObbligatorio | Valori e limiti 768P, 1080P | Predefinito— |

Combinazioni di materiali in input

**Da testo a video** · Obbligatorio: prompt

Parametri e ciclo di vita del metodo

| Parametro | Contratto |
| --- | --- |
| Parametro`content_type` | Contrattoapplication/json |
| Parametro`required` | Contrattomodel, prompt, duration, resolution |
| Parametro`other_options` | Contrattofalse |
| Parametro`duration` | Contratto6 |
| Parametro`resolution` | Contratto768P, 1080P |
| Parametro`prompt_max_characters` | Contratto2000 |
| Parametro`material_types` | Contrattotext |
| Parametro`prompt_max_characters_by_resolution` | Contratto{"768P":2000,"1080P":199} |

Alias del metodo: `/v1/videos/generations`, `/videos`, `/videos/generations`

Ciclo di vita: `submit_once_poll_original`

`GET /v1/videos/{request_id}`

`GET /v1/videos/generations/{request_id}`

`GET /v1/videos/{request_id}/content`

`GET /v1/videos/generations/{request_id}/content`

Crea una sola volta e salva l'ID restituito.

Interroga periodicamente lo stato originale; conserva ogni risorsa completata e la relativa durata.

### Tariffe

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 Ailoot

#### Prezzi per configurazione

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

| Configurazione | Listino delle tariffe | Durata nominale del clip, secondi | Risoluzione | Unità di fatturazione | Costo |
| --- | --- | --- | --- | --- | --- |
| ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Durata nominale del clip, secondi— | Risoluzione— | Unità di fatturazione— | Costo Input · Token in input **—** / 1K token Output · Token in output **—** / 1K token Input · Lettura dalla cache **—** / 1K token Input · Scrittura nella cache **—** / 1K token Input · Scrittura nella cache, 1 ora **—** / 1K token |
| ConfigurazioneUltra | Listino delle tariffe— | Durata nominale del clip, secondi6 | Risoluzione1080P | Unità di fatturazioneper clip in output di durata nominale 6s | Costo Output · clip in uscita di durata nominale 6s **$1.2** per clip in output di durata nominale 6s |
| ConfigurazioneUltra | Listino delle tariffe— | Durata nominale del clip, secondi6 | Risoluzione768P | Unità di fatturazioneper clip in output di durata nominale 6s | Costo Output · clip in uscita di durata nominale 6s **$0.6** per clip in output di durata nominale 6s |

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.

MiniMax-Hailuo-2.3

#### Prezzi per configurazione

| Configurazione | Condizioni di fatturazione | Costo |
| --- | --- | --- |
| ConfigurazioneMiniMax-Hailuo-2.3 · Configurazione predefinita | Condizioni di fatturazioneConfigurazione predefinita | Costo Input · Input **0,00 USD** per chiamata Output · Output **0,60 USD** per chiamata |

MiniMax-Hailuo-2.3

#### Prezzi per configurazione

| Configurazione | Condizioni di fatturazione | Costo |
| --- | --- | --- |
| ConfigurazioneMiniMax-Hailuo-2.3 · Configurazione predefinita | Condizioni di fatturazioneConfigurazione predefinita | Costo Input · Input **0,00 USD** per chiamata Output · Output **1,20 USD** per chiamata |

MiniMax-Hailuo-2.3

#### Prezzi per configurazione

| Configurazione | Condizioni di fatturazione | Costo |
| --- | --- | --- |
| ConfigurazioneMiniMax-Hailuo-2.3 · Configurazione predefinita | Condizioni di fatturazioneConfigurazione predefinita | Costo Input · Input **0,00 USD** per chiamata Output · Output **1,20 USD** per chiamata |

### Esempi di richieste

#### Ailoot Ultra · Video

curlcurl · 1080P / 6 secondi

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "MiniMax-Hailuo-2.3", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "768P"}')

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
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
```

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "MiniMax-Hailuo-2.3", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "1080P"}')

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
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
```

### Ricevi e salva i risultati

#### Ailoot Ultra · Video

mp4

- `GET /v1/videos/{request_id}`
- `GET /v1/videos/generations/{request_id}`
- `GET /v1/videos/{request_id}/content`
- `GET /v1/videos/generations/{request_id}/content`

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

GET stato

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json
python3 - <<'PY_STATUS'
import json
from pathlib import Path
r=json.loads(Path("status.json").read_text())
print(json.dumps(r))
if r.get("status")=="completed":
    for x in r.get("data",[]):print(x)
PY_STATUS
```

##### Salva tutte le risorse completate

GET tutte le risorse completate

```bash
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
```

Altre letture di contenuto

GET contenuto

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id/content" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4
```

##### Conserva tutti i risultati completati

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

A completamento, data\[\] contiene tutti gli URL firmati dei contenuti di tua proprietà. Recupera ogni URL restituito oppure usa l'endpoint del contenuto impostando index su un indice di uscita effettivo. Un'attività originale non riuscita può restituire charge\_pending\_check; verifica quell'attività originale invece di crearla nuovamente.

##### Se occorre verificare la risposta originale

Consulta l'attività originale esistente; non ripetere mai un invio dall'esito sconosciuto.

Numero massimo di output: 1.

Campi della risposta

| Campo | Tipo |
| --- | --- |
| Campo`id` | Tipostring |
| Campo`object` | Tipostring |
| Campo`model` | Tipostring |
| Campo`status` | Tipostring |
| Campo`data[]` | Tiposigned content URL |
| Campo`charge_pending_check` | Tipoboolean |
| Campo`error.code` | Tipostring |
| Campo`error.message` | Tipostring |
| Campo`requested_nominal_duration_seconds` | Tipointeger |
| Campo`measured_duration_seconds` | Tiponumber |
| Campo`width` | Tipointeger |
| Campo`height` | Tipointeger |

Errori e passaggi successivi

| Risposta | Condizione | Passaggio successivo |
| --- | --- | --- |
| Risposta400 · `invalid_request_error` | CondizioneCampi obbligatori, rappresentazione del materiale o valore del parametro non validi | Passaggio successivoCorreggi i campi indicati prima di una nuova richiesta di creazione. |
| Risposta409 · `video_not_ready` | CondizioneContenuto del risultato originale non ancora disponibile | Passaggio successivoInterroga periodicamente l'ID originale restituito e rispetta Retry-After. |
| Risposta`server_error` | CondizioneLa risposta restituita indica che l'operazione o il risultato richiede una verifica | Passaggio successivoConserva l'ID originale di operazione/task restituito, gli header della richiesta e la risposta; continua a leggere l'operazione originale tramite le modalità supportate. Non reinviare la richiesta di creazione. |

### Alias

#### Alias del modello

<strong>Ailoot</strong> [`MiniMax-Hailuo-2.3`](https://ailoot.ai/models/it/#m=MiniMax-Hailuo-2.3&route=Core&caller=MiniMax-Hailuo-2.3&fmt=videos)
**Ailoot Ultra** [`MiniMax-Hailuo-2.3`](https://ailoot.ai/models/it/#m=MiniMax-Hailuo-2.3&route=Ultra&caller=MiniMax-Hailuo-2.3&fmt=videos)

#### Alias dei percorsi dei metodi

`/v1/videos/generations`, `/videos`, `/videos/generations`

#### ID di chiamata correlati

[`MiniMax-Hailuo-2.3`](https://ailoot.ai/models/it/#m=MiniMax-Hailuo-2.3&route=Core&caller=MiniMax-Hailuo-2.3&fmt=videos), [`MiniMax-Hailuo-2.3`](https://ailoot.ai/models/it/#m=MiniMax-Hailuo-2.3&route=Ultra&caller=MiniMax-Hailuo-2.3&fmt=videos)

FAQ · MiniMax-Hailuo-2.3

Quali input e risultati sono disponibili?

`POST /v1/videos/generations` · `MiniMax-Hailuo-2.3`: `text`, `image` → `video` `POST /v1/videos` · `MiniMax-Hailuo-2.3`: `text` → `video`

Quali campi usa la richiesta?

`POST /v1/videos/generations` · `MiniMax-Hailuo-2.3`: `model`, `prompt`, `duration`, `resolution`, `first_frame_image`, `prompt_optimizer`, `fast_pretreatment` `POST /v1/videos` · `MiniMax-Hailuo-2.3`: `model`, `prompt`, `duration`, `resolution`

Quali limiti si applicano?

`POST /v1/videos/generations` · `MiniMax-Hailuo-2.3`: `prompt.maximum_length`: `2000` `POST /v1/videos` · `MiniMax-Hailuo-2.3`: `prompt.maximum_length`: `2000`

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.