MiniMax

Hailuo 2.3

hailuo-2.3-fast/image-to-video

Modello di generazione video lanciato da MiniMax, supporta sia la generazione di video da testo che da immagine; rispetto alla generazione precedente offre miglioramenti nella stabilità dello stile anime, nel rendering dei movimenti di tutto il corpo e nel realismo delle microespressioni facciali, ed è adatto alla creazione di cortometraggi anime e di video commerciali con una resa realistica.

hailuo-2.3-fast/image-to-video hailuo-2.3/image-to-video hailuo-2.3/text-to-video

Prova hailuo-2.3-fast/image-to-video

Input

Creazioni

Vedi tutte le creazioni

Output

video

Compila i parametri e genera: i risultati appariranno qui.

Prezzi

hailuo-2.3-fast/image-to-video per video

Specifiche	Prezzo unitario
6S	$0.270
10S	$0.460

Presentazione

Hailuo 2.3-Fast è la versione rapida della serie MiniMax Hailuo 2.3 dedicata alla generazione di video da immagine. Riceve un'immagine del primo fotogramma e un prompt testuale e genera un video di 6 o 10 secondi, puntando sulla naturalezza dei movimenti delle persone e delle microespressioni del volto, nonché su un output stabile per immagini stilizzate come l'animazione. È adatta agli sviluppatori che necessitano di test rapidi a partire da una singola immagine, di iterazione dello storyboard o di produzione di materiali video brevi, e si integra tramite l'interfaccia unificata di HiAPI.ai.

Punti salienti

Versione leggera e rapida per la generazione di video da immagine — nella stessa serie sono disponibili anche la versione completa e i modelli text-to-video; Fast si concentra sull'efficienza di produzione a partire da una singola immagine, ideale per test rapidi e iterazioni in fase iniziale.
Il primo fotogramma guida direttamente il movimento — è sufficiente fornire un'immagine del primo fotogramma in jpeg, png o webp e un prompt per generare una sequenza in movimento continuo.
Ottimizzazione automatica opzionale del prompt — prompt_optimizer è attivo per impostazione predefinita e migliora i risultati senza riscrivere il prompt.
Due durate: 6 e 10 secondi — cambiando la durata si bilanciano la lunghezza del materiale e il costo di generazione, coprendo esigenze di video brevi e bozze di storyboard.

Descrizione delle capacità

Generazione di video da un singolo primo fotogramma: passando un'immagine del primo fotogramma e una descrizione testuale si ottiene un video dinamico, convertendo direttamente materiale statico in una risorsa video riproducibile.

Il prompt testuale controlla l'immagine: il campo prompt supporta descrizioni fino a 2000 caratteri, usate per specificare azioni, inquadrature e contenuti visivi, orientando la direzione della generazione.

Durata selezionabile: duration offre due opzioni, 6 e 10 secondi; gli sviluppatori possono scegliere la lunghezza del video in base alla piattaforma di pubblicazione o alla struttura dello storyboard.

Ottimizzazione automatica del prompt: prompt_optimizer è attivo per impostazione predefinita e può completare e riscrivere automaticamente il prompt, riducendo i tentativi e i costi della messa a punto dei parametri.

Casi d'uso

Creatori di contenuti anime e stilizzati: immagine del personaggio + prompt di animazione — trasformare illustrazioni o character design in brevi clip animate, per cortometraggi anime, contenuti per social network o poster dinamici.
Team di video brevi: immagine di una persona + descrizione della performance — generare a partire dal primo fotogramma di una persona clip con danza, movimenti del corpo o espressioni del volto, da usare come materiale finale o bozza di storyboard.
Prodotti e promozione commerciale: immagine del prodotto + script di presentazione — convertire un fotogramma statico del prodotto in un video di presentazione dinamico, per una rapida produzione di schede prodotto e-commerce, annunci in-feed o video promozionali.
Team creativi: test visivi dello script — generare rapidamente clip di 6 o 10 secondi da una singola immagine per validare la direzione creativa prima di decidere se passare alla produzione ufficiale.

Limiti e consigli per la scelta

Supporta solo la guida tramite un singolo primo fotogramma e non dispone del controllo del primo e dell'ultimo fotogramma; le immagini di input devono essere in jpeg, png o webp, mentre SVG non è supportato. La versione Fast è solo image-to-video e non offre la modalità text-to-video; se serve generare video da solo testo o la qualità della versione completa, occorre passare ai modelli text-to-video o image-to-video della versione completa della stessa serie. La risoluzione e la velocità di generazione non hanno parametri ufficiali a supporto: in fase di scelta si consiglia di eseguire prima un test pratico su piccola scala.

Novità

Vedi il changelog →

Nuovo modello Nuovo modello disponibile: hailuo-2.3-fast/image-to-video Nov 3, 2026

Domande frequenti

Vedi tutte le domande →

Hailuo 2.3 Image to Video richiede il caricamento di un'immagine?

Sì. Attualmente hailuo-2.3/image-to-video è un percorso image-to-video: l'immagine di input definisce il soggetto e la composizione iniziale, mentre il Prompt gestisce movimento, inquadratura e variazioni dell'ambiente.
Quali durate e risoluzioni supporta Hailuo 2.3 Image to Video?

L'attuale contratto di richiesta di HiAPI supporta 6s / 10s. I valori selezionabili fanno fede secondo il pannello dei parametri della pagina e la documentazione API.
Come viene fatturato Hailuo 2.3 Image to Video?

Le attività vengono fatturate per video, in base alla fascia di durata selezionata. La pagina mostra il prezzo in tempo reale nell'unità monetaria globale; l'addebito finale fa riferimento al record delle attività completate con successo.
Come migliorare la stabilità del soggetto nella generazione di video da immagini?

Usa un'immagine di input con soggetto nitido, poche occlusioni e composizione completa; nel Prompt descrivi prima l'azione principale e la ripresa, poi elenca l'aspetto, i materiali e le relazioni con lo sfondo che devono essere mantenuti. Per il primo test si consiglia una durata breve.

Crea un'attività di generazione

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringObbligatorio

Chiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API

Content-TypestringOpzionale

Il corpo della richiesta viene sempre interpretato come JSON; se inviato, è accettato solo application/json (charset facoltativo) — qualsiasi altro valore restituisce 415. Esempio: application/json.

Idempotency-KeystringOpzionale

Chiave di idempotenza, fino a 255 byte. I retry con la stessa chiave dello stesso account creano l'attività una sola volta; i replay restituiscono il taskId originale.

Chiave di idempotenza

In caso di timeout di rete o retry automatici del client, la stessa chiave crea l'attività una sola volta, senza doppi addebiti (ambito = l'account della chiave API). Usa un identificatore univoco di business (es. "order-42"); i replay restituiscono il taskId originale e le chiavi scadono 24 ore dopo la prima richiesta. La matrice completa degli scenari è nell'introduzione dell'API asincrona unificata.

Corpo

modelstringObbligatorio

Valore fisso attuale: hailuo-2.3-fast/image-to-video

routestringOpzionale

Valore fisso attuale: default

inputobjectObbligatorio

Oggetto di parametri di business per hailuo-2.3-fast/image-to-video e la route default — vedi la tabella dei parametri sotto.

promptstringObbligatoriominLength 1maxLength 2000

Descrizione testuale per la generazione del video, utilizzata per indicare il contenuto dell'immagine che si desidera generare. Accetta un valore stringa.

durationstringOpzionalePredefinito: "6"

Durata del video generato, in secondi. Accetta un valore numerico in forma di stringa, predefinito 6.

Opzioni:610

image_urlstringObbligatorio

URL dell'immagine del primo fotogramma, supporta solo una singola immagine, formato jpeg/png/webp, SVG non supportato. Accetta un valore stringa.

prompt_optimizerbooleanOpzionalePredefinito: true

Indica se ottimizzare automaticamente il prompt per ottenere risultati di generazione migliori. Accetta un valore booleano, predefinito true.

callbackobjectOpzionale

Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.

Callback (Webhook)

Fornisci callback.url in creazione e HiAPI invierà un POST al tuo servizio allo stato terminale, senza polling. Il corpo del callback replica la struttura del dettaglio attività; verifica firma, retry e idempotenza sono descritti nell'introduzione dell'API asincrona unificata.

urlstringObbligatorio

Obbligatoria se è presente callback. Allo stato terminale viene inviato un POST a questo URL; deve essere un URL http(s) valido.

whenstringOpzionalePredefinito: "final"

Al momento è supportato solo final: notifica sia su success sia su fail.

Opzioni:final

storagestringOpzionalePredefinito: "temp"

Livello di archiviazione degli artefatti: temp (predefinito, ~7 giorni) o persistent (a lungo termine, fatturato per dimensione). Saldo insufficiente o superamento del limite ⇒ declassamento silenzioso a temp; il livello effettivo è visibile nella risposta di dettaglio.

Opzioni:temppersistent

Esempi di richiesta

# Invia un'attività asincrona; restituisce subito un taskId (senza attendere la generazione)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "hailuo-2.3-fast/image-to-video",
  "input": {
    "prompt": "…",
    "duration": "6",
    "image_url": "…",
    "prompt_optimizer": true
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "hailuo-2.3-fast/image-to-video",
    input: {
      "prompt": "…",
      "duration": "6",
      "image_url": "…",
      "prompt_optimizer": true
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "hailuo-2.3-fast/image-to-video",
        "input": {
          "prompt": "…",
          "duration": "6",
          "image_url": "…",
          "prompt_optimizer": True
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Ottieni i dettagli dell'attività

GET https://api.hiapi.ai/v1/tasks/:id

Campi della risposta

taskIdstringObbligatorio

ID attività, sempre con prefisso tk-hiapi-.

modelstringObbligatorio

Nome completo risolto del modello. Le attività inviate con il parametro route restituiscono base@route (es. gpt-image-2/text-to-image@ext); altrimenti coincide con il nome inviato.

routestringOpzionale

Presente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.

statusstringObbligatorio

Stato dell'attività.

Valori di stato

queued In coda, non avviata. handling In elaborazione. archiving Elaborazione conclusa, preparazione artefatti. success Terminale: completato, artefatti disponibili (restituisce output). fail Terminale: errore (restituisce error). Dopo l'invio, segui status: success e fail sono terminali, il resto no. Esegui polling ogni 1–3 s fino allo stato terminale. In caso di successo scarica gli artefatti da output[].url e trasferiscili prima di expireAt; per conservazione lunga usa storage: "persistent" in creazione.

creatednumberObbligatorio

Istante di creazione dell'attività (secondi Unix).

completednumberObbligatorio

Secondi Unix dello stato terminale; 0 finché non terminale.

outputarrayOpzionale

Presente solo con status == success. Elenco artefatti — sempre un array; un'attività può restituire più type contemporaneamente (es. video + first_frame).

Array [ object ]

Elementi dell'array

urlstringObbligatorio

URL dell'artefatto, scaricabile direttamente.

typestringObbligatorio

Valori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.

expireAtnumberObbligatorio

Secondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.

errorobjectOpzionale

Presente solo con status == fail.

codestringObbligatorio

Codice errore di business.

messagestringObbligatorio

Descrizione dell'errore.

Esempi di risposta

Successo

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

In elaborazione (non terminale)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Non riuscito

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}