MiniMax
Hailuo 2.3
hailuo-2.3/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.
Prova hailuo-2.3/image-to-video
Input
Creazioni
Vedi tutte le creazioniOutput
videoPrezzi
hailuo-2.3/image-to-video per video
| Specifiche | Prezzo unitario |
|---|---|
| 6S | $0.400 |
| 10S | $0.800 |
Panoramica del posizionamento
hailuo-2.3/image-to-video è il modello image-to-video della serie MiniMax Hailuo 2.3 che genera video a partire da una singola immagine di primo frame, richiamabile tramite l'interfaccia unificata di HiAPI.ai. Si distingue nella resa dei movimenti delle persone e delle microespressioni facciali, mantenendo una buona stabilità nelle scene stilizzate come l'animazione e nelle scene con azioni a figura intera; è adatto a sviluppatori e team creativi che necessitano di estendere rapidamente materiali statici in brevi video. Supporta filmati di 6 o 10 secondi e consente di attivare su richiesta l'ottimizzazione automatica del prompt.
Punti chiave
- Fissa il punto di partenza dell'immagine con un singolo primo frame: è sufficiente fornire un'immagine di primo frame insieme a una descrizione testuale per generare un video dinamico che prosegue la composizione e lo stile.
- Movimenti delle persone e dettagli del volto più naturali: pensato per scene con persone in primo piano e complesse azioni a figura intera, con fluidità di movimento e realismo delle microespressioni rafforzati.
- Filmati più stabili per soggetti stilizzati e commerciali: mantiene una buona coerenza su immagini in stili particolari come l'animazione e su contenuti promozionali di prodotto, facilitando l'inserimento diretto nel flusso di lavoro.
Descrizione delle capacità
Generazione video guidata da una singola immagine: passando un'immagine di primo frame in formato jpeg, png o webp insieme a un prompt è possibile generare un video, senza bisogno di materiali multi-frame, ideale per estendere rapidamente risorse immagine già disponibili.
Due opzioni di durata: la durata del filmato può essere specificata tra 6 e 10 secondi, con valore predefinito di 6 secondi, per pianificare la produzione in base al posizionamento o alla lunghezza dello storyboard.
Ottimizzazione automatica del prompt: prompt_optimizer è attivo per impostazione predefinita; il modello completa e ottimizza automaticamente la descrizione, riducendo i costi di messa a punto del prompt; è possibile disattivarlo per preservare l'intento originale.
Controllo del contenuto visivo tramite descrizione testuale: il prompt può contenere fino a 2000 caratteri, usati per descrivere azioni, inquadrature e atmosfera desiderate, vincolando insieme all'immagine di primo frame l'andamento complessivo della scena.
Scenari applicativi
- Cortometraggi in stile animazione per creator di contenuti: con illustrazioni di personaggi o storyboard come input, si producono materiali video dinamici dallo stile coerente, per la pubblicazione e il montaggio di contenuti anime.
- Materiali animati per pubblicità e promozione di prodotti: inserendo immagini di prodotto e descrizioni della scena si generano brevi video di presentazione del prodotto, per pagine di dettaglio e-commerce e inserzioni nei feed.
- Animazione di materiali di performance umana: da foto di scena o scatti di posa si generano clip con azioni a figura intera ed espressioni facciali, per microdrammi, danza e contenuti social.
- Visualizzazione rapida di script creativi: con immagini concettuali si accelerano le prove di ripresa a ritmo serrato, validando a basso costo inquadrature e idee di azione per la revisione creativa e la conferma del progetto.
Limiti e consigli di selezione
Supporta solo la generazione guidata da una singola immagine di primo frame, senza controllo del primo e dell'ultimo frame, quindi il punto finale della scena non può essere vincolato con precisione; il risultato generato ha una durata fissa di 6 o 10 secondi e, in caso di necessità di una scansione temporale più fine, occorre intervenire in fase di montaggio. È adatto a brevi video di performance umana, scene stilizzate e prodotti commerciali; se è necessario concepire la scena da zero partendo da solo testo, conviene passare alla linea text-to-video della stessa serie; se si punta a un ciclo di prove ed errori in batch più rapido, si può considerare la versione della serie orientata a velocità e costo.
Novità
Vedi il changelog →- Nuovo modello Nuovo modello disponibile: hailuo-2.3-fast/image-to-video
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
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringObbligatorioChiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API
Content-TypestringOpzionaleIl 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-KeystringOpzionaleChiave 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.
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
modelstringObbligatorioValore fisso attuale: hailuo-2.3/image-to-video
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per hailuo-2.3/image-to-video e la route default — vedi la tabella dei parametri sotto.
promptstringObbligatoriominLength 1maxLength 2000Prompt testuale utilizzato per descrivere il contenuto video da generare.
durationstringOpzionalePredefinito: "6"Durata del video generato, in secondi; valore predefinito 6 secondi.
610image_urlstringObbligatorioURL dell'immagine del primo fotogramma, supporta solo una singola immagine; i formati supportati sono jpeg, png, webp, SVG non supportato.
prompt_optimizerbooleanOpzionalePredefinito: trueSe ottimizzare automaticamente il prompt per ottenere risultati di generazione migliori; valore predefinito true.
callbackobjectOpzionale
Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.
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.
urlstringObbligatorioObbligatoria 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.
finalstoragestringOpzionalePredefinito: "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.
temppersistentEsempi 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/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/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/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à
https://api.hiapi.ai/v1/tasks/:id Campi della risposta
taskIdstringObbligatorioID attività, sempre con prefisso tk-hiapi-.
modelstringObbligatorioNome 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.
routestringOpzionalePresente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.
statusstringObbligatorioStato dell'attività.
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.
creatednumberObbligatorioIstante di creazione dell'attività (secondi Unix).
completednumberObbligatorioSecondi 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
urlstringObbligatorioURL dell'artefatto, scaricabile direttamente.
typestringObbligatorioValori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.
expireAtnumberObbligatorioSecondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.
errorobjectOpzionale
Presente solo con status == fail.
codestringObbligatorioCodice errore di business.
messagestringObbligatorioDescrizione 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"
}
}
} Articoli
Vedi tutti gli articoli →-
Tutoriale
Utilizzare Kandinsky 6.0 Pro su HiAPI per la generazione di video da testo: tutorial con curl e Python
Dimostrazione pratica guidata dalla richiesta: costruire la chiamata da prompt a clip video, inviare la richiesta, monitorare lo stato di completamento e scaricare il risultato
-
Tutoriale
Come chiamare hailuo-2.3-fast/image-to-video tramite l'API HiAPI: pratica con curl e Python
La prima richiesta funzionante per il livello image-to-video veloce ed economico — dall'ID del modello al download di un MP4
-
Tutoriale
Tutorial su kandinsky-6.0-pro/image-to-video tramite HiAPI: curl + Python
Avvia una richiesta funzionante di image-to-video su HiAPI: dal caricamento del primo fotogramma al polling asincrono fino al download finale
-
Tutoriale
Come chiamare hailuo-2.3/text-to-video tramite l'API HiAPI: curl, Python ed esempi di richiesta eseguibili
-
Tutoriale
Come usare kling-4.0/text-to-video tramite l'API HiAPI: curl, Python e un esempio di richiesta funzionante
Guida pratica per sviluppatori: prompt cinematografici, audio sincronizzato, polling asincrono e download dell'output
-
Tutoriale
Come chiamare kling-4.0/image-to-video su HiAPI: curl, Python e polling
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
Wan 2.7 Video Alibaba $0.100 /secondo -
Kling AI Avatar Kuaishou -- -
HappyHorse 1.1 Alibaba $0.160 /secondo -
FLUX 3 Max Black Forest Labs $0.061 /secondo -
Kandinsky 6.0 Pro $1.93 /video -
Wan 3.0 Video Alibaba $0.040 /secondo -
Grok Imagine 1.5 xAI $0.011 /secondo -
Kling 3.0 Kuaishou $0.100 /secondo -
Gemini Omni 1.1 Flash Google $0.450 /video -
HappyHorse 1.0 Alibaba $0.168 /secondo -
HeyGen Avatar IV HeyGen $0.150 /secondo -
Vidu Q3 Vidu $0.149 /secondo



