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.
", "aboutText": "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.\n\nLa 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.\n\nLa 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.\n\nIl 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.\n\nIl 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.\n\nPer 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.\n\nL’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.\n\nHailuo 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.\n\nLa 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.\n\nL’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.\n\nIl 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.\n\nControlla 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.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "6ea9fae9f398a866f5b7fcfe5c35c1abb912409cc8c13a8c887a881a89081271", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "it", "methods": [ { "html": "MiniMax-Hailuo-2.3MiniMax 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.
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.
POST /v1/videos/generationstext, imagevideo| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti MiniMax-Hailuo-2.3 | Predefinito— |
Campoprompt | Tipostring | RequisitoObbligatorio | Valori e limiti Lunghezza minima: 1 Lunghezza massima: 2000 Unità: caratteri Unicode | Predefinito— |
Campoduration | Tipointeger | RequisitoFacoltativo | Valori e limiti 6, 10 Condizioni: 10 secondi richiedono 768P Unità: secondi | Predefinito6 |
Camporesolution | Tipostring | RequisitoFacoltativo | Valori e limiti 768P, 1080P Condizioni: 1080P richiede 6 secondi | Predefinito768P |
Campofirst_frame_image | Tipohttps_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— |
Campoprompt_optimizer | Tipoboolean | RequisitoFacoltativo | Valori e limiti | Predefinito— |
Campofast_pretreatment | Tipoboolean | RequisitoFacoltativo | Valori e limiti | Predefinito— |
Da immagine a video · Obbligatorio: prompt, first_frame_image
Da testo a video · Obbligatorio: prompt
| Parametro | Contratto |
|---|---|
Parametromaterial_types | Contrattotext, image |
Parametrorequired | Contrattonull |
Parametrooptional_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.
POST /v1/videos/generationsAiloot 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 →
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.
| 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 |
| 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 |
| 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 |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl https://api.ailoot.ai/v1/videos/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" \\\n -H "Content-Type: application/json" \\\n -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"}'mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_VIDEO_ID\nvideo_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1\ncurl "https://api.ailoot.ai/v1/videos/generations/$video_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY"set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_VIDEO_ID\nvideo_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1\ncurl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" \\\n --output video.mp4Salva 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.
Consulta l'attività originale esistente; non ripetere mai un invio dall'esito sconosciuto.
| Campo | Tipo |
|---|---|
Campoid | Tipostring |
Campoobject | Tipostring |
Campomodel | Tipostring |
Campostatus | Tipostring |
Campocontent_url | Tiposigned URL |
Campodata[] | Tiposigned URL |
Campousage | Tipoobject |
Camporesult_pending_check | Tipoboolean |
| 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. |
Rispostaserver_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. |
Ailoot MiniMax-Hailuo-2.3
Ailoot Ultra MiniMax-Hailuo-2.3
/v1/videos/generations, /videos, /videos/generations
MiniMax-Hailuo-2.3MiniMax 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.
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.
POST /v1/videostextvideo| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti MiniMax-Hailuo-2.3 | Predefinito— |
Campoprompt | Tipostring | 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— |
Campoduration | Tipointeger | RequisitoObbligatorio | Valori e limiti 6 Unità: secondi | Predefinito— |
Camporesolution | Tipostring | RequisitoObbligatorio | Valori e limiti 768P, 1080P | Predefinito— |
Da testo a video · Obbligatorio: prompt
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, prompt, duration, resolution |
Parametroother_options | Contrattofalse |
Parametroduration | Contratto6 |
Parametroresolution | Contratto768P, 1080P |
Parametroprompt_max_characters | Contratto2000 |
Parametromaterial_types | Contrattotext |
Parametroprompt_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.
Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.
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 →
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.
| 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 |
| 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 |
| 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 |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "MiniMax-Hailuo-2.3", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "768P"}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "MiniMax-Hailuo-2.3", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "1080P"}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif 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")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n 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")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\nSalva 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.
Consulta l'attività originale esistente; non ripetere mai un invio dall'esito sconosciuto.
Numero massimo di output: 1.
| Campo | Tipo |
|---|---|
Campoid | Tipostring |
Campoobject | Tipostring |
Campomodel | Tipostring |
Campostatus | Tipostring |
Campodata[] | Tiposigned content URL |
Campocharge_pending_check | Tipoboolean |
Campoerror.code | Tipostring |
Campoerror.message | Tipostring |
Camporequested_nominal_duration_seconds | Tipointeger |
Campomeasured_duration_seconds | Tiponumber |
Campowidth | Tipointeger |
Campoheight | Tipointeger |
| 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. |
Rispostaserver_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. |
Ailoot MiniMax-Hailuo-2.3
Ailoot Ultra MiniMax-Hailuo-2.3
/v1/videos/generations, /videos, /videos/generations