MiniMax H3
Crea video
MiniMax H3 APIMiniMax-H3 · API di generazione video · minimaxh3.video

API MiniMax H3 per la generazione video in produzione

Crea flussi da testo a video, con controllo del primo e dell'ultimo fotogramma o riferimenti omni, tramite l'API MiniMax H3. Un'unica interfaccia asincrona restituisce prima task_id, quindi l'URL da cui scaricare il contenuto.

Apri il generatoreLeggi la guida ai prompt
POST /api/v1/video_generation200 · task_id
curl --request POST \
  --url https://minimaxh3.video/api/v1/video_generation \
  --header "Authorization: Bearer $MINIMAX_H3_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "MiniMax-H3",
    "content": [
      {
        "type": "text",
        "text": "Un ciclista attraversa una strada cittadina illuminata dalla pioggia di notte, riflessi al neon sull'asfalto bagnato, camera che segue la bicicletta."
      }
    ],
    "duration": 5,
    "resolution": "2K",
    "ratio": "16:9"
  }'
Endpoint
POST /api/v1/video_generation
ID modello
MiniMax-H3
Flusso
Attività asincrona
Output
2K · 4–15s
Autenticazione
Chiave API Bearer
Limite del prompt
7.000 caratteri
Contratto API

Un endpoint MiniMax H3, tre modalità creative.

MiniMax-H3 usa un array multimodale content. I ruoli assegnati stabiliscono se la richiesta genera un video da testo, da immagini iniziali e finali oppure da contenuti di riferimento.

01content: text

Da testo a video (t2va)

Invia l'elemento di testo obbligatorio e lascia che il modello crei l'intera inquadratura. Nella generazione solo da testo, ratio è obbligatorio e non può essere adaptive.

02content: text + images

Primo / ultimo fotogramma (i2va)

Aggiungi elementi image_url con ruolo first_frame ed eventualmente last_frame per controllare la composizione iniziale e quella finale.

03content: text + refs

Generazione da riferimenti (r2va)

Guida personaggio, movimento, camera, stile o voce con immagini, video e audio di riferimento, senza mescolarli ai ruoli del primo e dell'ultimo fotogramma.

Cosa espone l'API

Controlla scena, riferimenti e formato di output.

MiniMax H3 è presentato nella documentazione come un modello video multimodale aperto e generalista. L'interfaccia V2 è pensata per i backend di prodotto, non soltanto per prove occasionali.

Input multimodale

Testo, immagine, video e audio in una richiesta

Ogni elemento di content ha un tipo e può avere un ruolo. I riferimenti audio devono essere accompagnati da un'immagine o un video.

Intervallo di output

2K nativo per 4–15 secondi

duration accetta valori interi da 4 a 15 secondi. Sono supportate le proporzioni più comuni; adaptive è consentito quando è il contenuto multimediale a definire il formato.

Spazio per il prompt

Fino a 7.000 caratteri di istruzioni

Usa lo spazio disponibile per struttura della ripresa, movimento, percorso della camera, intenzione dei dialoghi e associazione dei riferimenti, non per accumulare parole chiave.

Compatibilità dei ruoli

Fotogrammi iniziale/finale e riferimenti si escludono a vicenda

Se è presente un ruolo reference_*, first_frame e last_frame non devono comparire. Validare questa regola evita risposte 400 facilmente prevenibili.

Risultato asincrono

task_id → status → content.url

Le attività completate restituiscono un URL di download con scadenza direttamente nella risposta alla query. Salva gli identificatori e archivia il file se deve restare disponibile nel tempo.

Gestione delle attività

Elenco, annullamento e finestre di scadenza

La V2 documenta le operazioni di elenco, annullamento/eliminazione e una breve finestra di consultazione per le attività recenti: gestisci la generazione come un processo in coda, non come un'unica lunga chiamata HTTP.

Casi d'uso

Cosa costruiscono i team con l'API MiniMax H3

Usa lo stesso flusso asincrono per singoli contenuti creativi, strumenti per creator o pipeline in batch.

Prodotti per creator

Generazione di riprese nell'app

Consenti agli utenti di inviare un prompt o un primo fotogramma, mostra lo stato della coda e consegna una clip in 2K quando l'attività si conclude.

Sistemi di brand

Campagne guidate da riferimenti

Mantieni i riferimenti a personaggio, prodotto, movimento o voce tra diverse riprese brevi, senza dover ricostruire ogni volta l'identità.

Strumenti editoriali

Transizioni primo-ultimo fotogramma

Controlla la composizione iniziale e quella finale quando la continuità dello storyboard conta più della libera improvvisazione.

Pipeline social

Rapporti verticali e cinematografici

Genera aperture in 9:16 o riprese master in 16:9 attraverso un'unica integrazione, variando soltanto ratio e duration.

Backend per agenti

Attività multimodali in coda

Gli agenti possono comporre array content, verificare periodicamente lo stato e passare content.url alle fasi di archiviazione, moderazione o montaggio.

Studi di prototipazione

Test rapidi di regia

Esplora combinazioni di camera, interpretazione e riferimenti prima di investire in una pipeline di produzione completa.

Flusso asincrono

Dalla API key a un video MiniMax H3 scaricabile

La generazione non richiede di mantenere aperta una richiesta HTTP. Salva gli identificatori e segui i passaggi V2 descritti nella documentazione.

01
Crea

Invia un'attività di generazione

Invia tramite POST model MiniMax-H3, un array content, duration, resolution e, quando richiesto, ratio. Una risposta valida restituisce task_id.

POST /api/v1/video_generation
02
Monitora

Controlla lo stato dell'attività

Interroga l'attività finché non raggiunge uno stato finale. queued e running sono normali stati intermedi.

GET /api/v1/video_generation/{task_id}
03
Recupera

Scarica content.url

Quando lo stato è succeeded, la risposta include content.url. L'URL ha una scadenza: copia il file in uno spazio di archiviazione sotto il tuo controllo se deve restare disponibile.

content.url · mp4
Struttura della richiesta

I campi necessari per una richiesta MiniMax-H3 affidabile

Rendi esplicita la richiesta pubblica e convalida le combinazioni previste da ciascuna modalità prima di inviare un'attività.

Obbligatorio

model

Usa l'identificatore esatto MiniMax-H3 indicato nella documentazione. Non sostituirlo con nomi commerciali o abbreviazioni.

Corpo multimodale obbligatorio

content[]

Inserisci almeno un elemento type=text. Per le modalità controllate, aggiungi elementi image_url, video_url o audio_url con i relativi ruoli.

4–15 secondi interi

duration

Scegli una durata espressa in secondi interi. Una ripresa non migliora allungandola, se basta una sola azione chiara.

Output documentato

resolution

La documentazione indica per MiniMax H3 un output in 2K. Prima del rilascio, verifica i valori enum attuali nella documentazione API aggiornata.

Controllo del formato

ratio

È obbligatorio nella generazione solo da testo e in tale modalità non può essere adaptive. I flussi basati su immagini possono mantenere le proporzioni della sorgente.

Ruoli multimediali facoltativi

first_frame · last_frame · reference_*

I ruoli modificano il comportamento creativo. Al momento del caricamento, convalida l'esclusione reciproca e i limiti di dimensione per ogni file.

Stato dell'attività

Gestisci status come una macchina a stati

I client che interrogano periodicamente l'API devono gestire gli stati intermedi e fermarsi soltanto al raggiungimento di un esito finale documentato.

StatoSignificatoComportamento applicativo consigliato
queuedIn attesa di capacitàSalva task_id e aumenta l'intervallo tra le richieste
runningGenerazione in corsoMantieni visibile l'attività ed evita invii duplicati
succeededVideo prontoLeggi content.url e archivia l'asset
failedGenerazione non completataMostra codice e messaggio di errore e consenti un nuovo tentativo esplicito
cancelledAttività annullataChiudi l'interfaccia dell'attività e conserva un registro
expiredAttività non più disponibileNon continuare a interrogarla all'infinito; ricreala se necessario

Solo le attività recenti restano consultabili. Verifica il periodo di conservazione ufficiale prima di progettare flussi di ripristino a lungo termine.

Limiti di input

Valida i media prima che raggiungano MiniMax H3

I limiti documentati sono abbastanza semplici da applicare durante il caricamento, così da prevenire errori evitabili.

Immagini

JPG, JPEG, PNG, WEBP, HEIC, HEIF · ≤ 30 MB

Larghezza e altezza comprese in [256, 5760]; proporzioni tra 2:5 e 5:2. Primo fotogramma ≤ 1, ultimo fotogramma ≤ 1, immagini di riferimento ≤ 9.

Video

MP4/MOV con H.264/H.265 · ≤ 50 MB ciascuno

Fino a 3 clip di riferimento, ciascuna di 2–15 s, per un totale ≤ 15 s. L'audio contenuto nel video può essere AAC o MP3.

Audio

WAV o MP3 · ≤ 15 MB ciascuno

Fino a 3 clip, ciascuna di 2–15 s, per un totale ≤ 15 s. L'audio non può essere inviato da solo: abbinalo a immagini o video di riferimento.

Riferimenti misti

Al massimo 12 file multimediali per richiesta

Il corpo della richiesta deve restare entro 64 MB. Per i file di grandi dimensioni, preferisci URL pubblici al Base64.

Modalità incompatibili

Non mescolare primo/ultimo fotogramma e ruoli di riferimento

Scegli il controllo della composizione iniziale/finale oppure la generazione con riferimenti omni, non entrambi nello stesso array content.

Prompt

Mantieni le istruzioni entro 7.000 caratteri

Associa esplicitamente i riferimenti nel testo quando identità, voce o movimento devono seguire un file specifico.

I prezzi restano sulla pagina dei prezzi

Il consumo di crediti e i limiti dei piani possono cambiare. Rimanda alla pagina aggiornata dei prezzi di MiniMax H3, anziché inserire un valore fisso nell'integrazione.

Scenari adatti

Quando scegliere la generazione asincrona di MiniMax H3

Scegli l'API V2 se il tuo prodotto può creare un'attività e attendere che il contenuto venga generato.

Ideale per

Servizi backend e strumenti per creator

Generazione in coda, archiviazione persistente e interfacce di stato si integrano naturalmente con un flusso basato su task_id.

Ideale per

Controllo creativo multimodale

Riprese che combinano le istruzioni del prompt con fotogrammi iniziali, fotogrammi finali o contenuti di riferimento.

Limite

Non è un flusso video in tempo reale

Prevedi interrogazioni periodiche o processi interni in coda, anziché mantenere aperta una connessione di generazione.

Limite

Progetta attività, non connessioni aperte

Gestisci le generazioni più lunghe nella coda del backend e mostra lo stato nell'interfaccia del prodotto.

Domande API

Domande sull'API MiniMax H3

Risposte pratiche prima di integrare la prima richiesta in produzione.

MiniMax-H3 è l'ID modello di questa API?

Sì. Quando crei un'attività, invia model MiniMax-H3 all'endpoint di generazione video MiniMax H3.

Quale endpoint devo chiamare?

Crea l'attività con POST https://minimaxh3.video/api/v1/video_generation, quindi interrogala con GET https://minimaxh3.video/api/v1/video_generation/{task_id}. Quando si conclude, scarica il file MP4 da content.url.

In cosa differisce MiniMax H3 dall'integrazione Hailuo 2.3?

H3 è l'attuale modello multimodale generalista: usa il contratto content[], offre output in 2K, duration di 4–15 s e riferimenti omni. Hailuo 2.3 è una famiglia precedente, con una struttura delle richieste diversa.

Posso combinare il controllo primo fotogramma con audio di riferimento?

Non nella stessa richiesta. I ruoli first/last-frame e reference_* si escludono a vicenda. Scegli la modalità che corrisponde al controllo di cui hai bisogno.

Come mi autentico?

Invia una chiave API Bearer nell'header Authorization. Dopo aver ottenuto l'accesso, puoi creare e gestire le chiavi dalle impostazioni del tuo account MiniMax H3.

Dove devo confermare i prezzi attuali?

Consulta la pagina dei prezzi del sito per piani e crediti. L'uso dell'API segue le regole del saldo crediti pubblicate in quella pagina.

Pronto per integrare MiniMax H3

Prototipa la ripresa. Invia la richiesta API.

Definisci la direzione creativa nel generatore, quindi chiama l'API MiniMax H3 su minimaxh3.video usando la tua chiave.

Apri il generatoreLeggi la guida ai prompt