MiniMax
MiniMax H3 Max Turbo
minimax-h3-max-turbo/image-to-video
Modello video MiniMax con profilo ottimizzato per la velocità, supporta la generazione di video da testo e da immagine (con primo fotogramma specificabile e ultimo fotogramma opzionale), genera in una singola esecuzione clip da 1 a 15 secondi, da 480P a 1080P, ideale per la produzione rapida di brevi video di marketing e per la previsualizzazione dello storyboard
Prova minimax-h3-max-turbo/image-to-video
Input
Creazioni
Vedi tutte le creazioniOutput
videoPrezzi
minimax-h3-max-turbo/image-to-video per second
| Specifiche | Prezzo unitario |
|---|---|
| 480P | $0.025 |
| 768P | $0.040 |
| 1080P | $0.080 |
Panoramica e posizionamento
Genera un clip video usando una singola immagine come primo fotogramma; la tela di output segue le proporzioni dell'immagine di input. Ideale per gli sviluppatori che vogliono trasformare un'immagine statica in un breve filmato dinamico, utilizzabile per la produzione rapida di contenuti social, per la previsualizzazione dinamica di storyboard pubblicitari o per la presentazione animata di materiali visivi. Supporta un'immagine di ultimo fotogramma opzionale per vincolare la scena finale, e consente di controllare il risultato tramite prompt, durata e parametri di risoluzione.
Punti di forza principali
- Generazione guidata dal primo fotogramma — carica un'immagine come primo fotogramma: la tela del video di output mantiene le proporzioni di quell'immagine, garantendo la coerenza del punto di partenza della composizione.
- Chiusura vincolata dall'ultimo fotogramma opzionale — fornendo un'immagine di fotogramma finale aggiuntiva, la scena conclusiva del video converge verso l'immagine specificata, ideale per transizioni o chiusure a fermo immagine.
- Durata e risoluzione regolabili — la durata di ogni generazione è selezionabile tra 1 e 15 secondi; la risoluzione offre tre opzioni tra cui scegliere: 480P, 768P e 1080P.
- Seed controllabile e riproducibile — il parametro seed fissa il seme casuale, facilitando la riproduzione o la messa a punto dello stesso andamento visivo nelle generazioni in batch.
Descrizione delle capacità
Generazione video da immagine con primo fotogramma: specifica l'immagine del primo fotogramma tramite image_url e genera un video dinamico combinando il prompt; la tela di output segue le proporzioni di quell'immagine, ideale per trasformare immagini statiche in clip dinamiche.
Vincolo della scena dell'ultimo fotogramma: partendo dal primo fotogramma, è possibile passare anche end_image_url come fotogramma finale, facendo convergere la scena conclusiva del video verso l'immagine specificata, per transizioni o inquadrature a fermo immagine.
Controllo di durata e risoluzione: duration è impostabile tra 1 e 15 secondi; l'output effettivo può essere più lungo di circa 0,7 secondi rispetto alla richiesta. resolution offre tre opzioni tra cui scegliere: 480P, 768P e 1080P; il 1080P è un upscaling raffinato basato sulla generazione nativa a 768P.
Regolazione dell'espansione del prompt: prompt_expansion_mode può essere disabled, balanced o quality, rispettivamente per saltare l'espansione, ottenere una risposta rapida o impiegare circa 30 secondi per generare un prompt più ricco, aiutando a controllare i dettagli della generazione.
Casi d'uso
- Animazione di immagini per i social media — gli operatori usano immagini di prodotto o poster come primo fotogramma, insieme a un breve prompt, per generare rapidamente brevi video dinamici da pubblicare sui social o utilizzare come materiale per i feed.
- Previsualizzazione dinamica di storyboard pubblicitari — i team di pre-produzione pubblicitaria o audiovisiva usano immagini chiave più un'immagine di fotogramma finale per generare clip di transizione, come previsualizzazione dinamica dello storyboard per proposte interne o riferimenti per le riprese.
- Conversione di materiali visivi in clip video — i creatori di contenuti usano fotografie o illustrazioni come primo fotogramma per generare brevi filmati dinamici di alcuni secondi, da usare per mostrare il portfolio o come inquadrature di transizione nel montaggio video.
- Realizzazione di inquadrature finali a fermo immagine — usando due immagini, primo e ultimo fotogramma, per vincolare l'inizio e la fine della scena, si genera un breve video che passa dalla scena iniziale a quella finale specificata, per effetti di fermo immagine in apertura o chiusura.
Limiti e suggerimenti per la scelta
L'immagine del primo fotogramma image_url è obbligatoria: non è supportata la generazione da solo testo. L'immagine dell'ultimo fotogramma è un vincolo opzionale e non garantisce che la scena converga esattamente su quell'immagine. Con resolution impostata su 1080P l'output è un upscaling raffinato basato sulla generazione nativa a 768P, non una generazione nativa a 1080P. duration è impostabile tra 1 e 15 secondi; l'output effettivo può essere più lungo di circa 0,7 secondi rispetto alla richiesta. Il prompt può contenere al massimo 50000 caratteri e il link dell'immagine al massimo 50000 caratteri. Il risultato della generazione non garantisce la coerenza assoluta dei personaggi né la riproduzione esatta della scena.
Novità
Vedi il changelog →- Nuovo modello MiniMax H3 Max Turbo disponibile: testo in video e immagine in video con fotogrammi iniziale e finale
Domande frequenti
Vedi tutte le domande →-
Il 1080P di questo modello è una generazione nativa?
Non è una generazione nativa: il 1080P si ottiene da una fonte 768P tramite un raffinamento nello spazio latente; il livello massimo generato nativamente dal modello è 768P. Se hai requisiti rigorosi sui dettagli dell'immagine, ti consigliamo di valutare in base alla generazione nativa a 768P, oppure di passare a un livello che supporta il master 2K.
-
Nella generazione di video da immagine è possibile utilizzare un'immagine di riferimento per bloccare il personaggio?
Al momento non è supportata la generazione di video da immagini di riferimento. image_url viene utilizzato solo come frame iniziale: la tela di generazione segue questa immagine e non è possibile utilizzare immagini di riferimento, clip di riferimento o audio per bloccare personaggio e stile. Per i casi che richiedono coerenza del personaggio è necessario passare a un livello che supporti la generazione di video da immagini di riferimento.
-
Come si impostano il primo e l'ultimo frame per controllare il punto di arrivo dell'inquadratura?
Usa image_url per specificare il primo frame e l'end_image_url opzionale per specificare l'ultimo frame: il modello interpola il movimento tra i due. Il primo frame determina l'intera tela di output, quindi la composizione e le proporzioni dell'ultimo frame devono essere simili a quelle del primo, altrimenti l'interpolazione tende a produrre deformazioni.
-
La durata del video generato può superare i 15 secondi?
La durata massima di una singola generazione è di 15 secondi, non è possibile produrre in una sola volta clip più lunghe. L'output effettivo può essere più lungo di circa 0,7 secondi rispetto al valore duration inserito. Se serve un video più lungo, generare segmenti separati per inquadratura e poi unirli.
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: minimax-h3-max-turbo/image-to-video
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per minimax-h3-max-turbo/image-to-video e la route default — vedi la tabella dei parametri sotto.
seedintegerOpzionaleSeme casuale utilizzato per controllare la casualità dei risultati generati; se omesso, viene scelto automaticamente un seme casuale.
promptstringObbligatoriominLength 1maxLength 50000Prompt testuale utilizzato per la generazione del video.
durationnumberOpzionalePredefinito: 5min 1max 15Durata del video in secondi, valore predefinito 5 secondi; l'output effettivo può essere più lungo del valore richiesto fino a circa 0,7 secondi. Quando viene fornito target_audio_url, la durata deve essere di almeno 2 secondi.
image_urlstringObbligatoriomaxLength 50000URL dell'immagine utilizzata come primo fotogramma; la tela di output seguirà questa immagine.
resolutionstringOpzionalePredefinito: "768P"Risoluzione di generazione, valore predefinito 768P; è possibile specificare anche 1080P, nel qual caso viene eseguito un raffinamento nello spazio latente a partire dalla sorgente nativa 768P.
480P768P1080Pend_image_urlstringOpzionaleOpzionale, URL dell'immagine utilizzata come ultimo fotogramma.
target_audio_urlstringOpzionaleOpzionale, URL del frammento audio da fissare alla colonna sonora generata; l'audio deve durare almeno 2 secondi e avere una dimensione massima di 15 MB.
prompt_expansion_modestringOpzionalePredefinito: "balanced"Livello di impegno dedicato alla riscrittura del prompt prima della generazione, valore predefinito balanced: disabled salta l'espansione del prompt, balanced restituisce in circa 1 secondo, quality impiega fino a circa 30 secondi per generare prompt più ricchi.
disabledbalancedqualitycallbackobjectOpzionale
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": "minimax-h3-max-turbo/image-to-video",
"input": {
"prompt": "…",
"duration": 5,
"image_url": "…",
"resolution": "768P",
"prompt_expansion_mode": "balanced"
}
}' 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: "minimax-h3-max-turbo/image-to-video",
input: {
"prompt": "…",
"duration": 5,
"image_url": "…",
"resolution": "768P",
"prompt_expansion_mode": "balanced"
}
}),
});
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": "minimax-h3-max-turbo/image-to-video",
"input": {
"prompt": "…",
"duration": 5,
"image_url": "…",
"resolution": "768P",
"prompt_expansion_mode": "balanced"
}
},
)
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 →Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
Kling 3.0 Turbo Kuaishou $0.144 /secondo -
Veo 3.1 Fast Google $0.170 /secondo -
HeyGen Avatar IV HeyGen $0.150 /secondo -
LTX 2.5 Fast Lightricks $0.086 /secondo -
Vidu Q4 Preview Vidu $0.051 /secondo -
Veo 3.1 Google $0.290 /secondo -
PixVerse V6 PixVerse $0.036 /secondo -
Gemini Omni 1.1 Google $0.450 /video -
HappyHorse 1.1 Alibaba $0.160 /secondo -
Runway Gen 4.5 Runway $0.172 /secondo -
Gemini Omni 1.2 Google $0.023 /secondo -
Muse Video 1.0 Meta $0.034 /video



