MiniMax H3 Max Turbo

Genera video di 5–15 secondi a 480P o 768P da testo o primo e ultimo fotogramma. Campi di richiesta, limiti delle immagini, prezzi per secondo di output e polling.

MiniMax H3 Max Turbo genera brevi video da testo o fotogrammi. Usa l’ID modello minimax-h3-max-turbo, conserva l’ID attività restituito e interroga l’attività per ottenere il video finito. Questa pagina descrive l’interfaccia nativa con array content offerta su SeedRouter.

ID modello

ID modello	Input	Risoluzioni	Durata
`minimax-h3-max-turbo`	testo, primo fotogramma, ultimo facoltativo	480P, 768P	5–15 secondi

Consulta la pagina del modello per i prezzi attuali.

Esempio rapido

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-max-turbo",
    "content": [
      {"type": "text", "text": "A small sailboat glides across a calm turquoise bay at sunrise, seagulls in the distance, the sound of water and wind. No text, no logos."}
    ],
    "resolution": "768P",
    "duration": 5,
    "ratio": "16:9"
  }'

Endpoint

POST https://api.seedrouter.ai/v1/videos/generations

Intestazione	Valore
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

La risposta è un'attività ({"id": "task_...", "status": "processing"}), non il video finito. Interroga GET /v1/tasks/{task_id} per ottenere il risultato. Conserva le chiavi API nel codice lato server.

Parametri

Campo	Tipo	Predefinito	Note
`model`	string	obbligatorio	`minimax-h3-max-turbo`
`content`	array	obbligatorio	Il prompt ed eventuali media, come voci descritte sotto. Esattamente una voce `text` non vuota.
`resolution`	enum	obbligatorio	`480P` o `768P`.
`duration`	integer	obbligatorio	Qualsiasi intero da 5 a 15 secondi.
`ratio`	enum	dipende dall'input	`adaptive`, `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`. Obbligatorio con il solo testo, dove `adaptive` non è accettato.
`extra`	object	omesso	Impostazioni facoltative di espansione del prompt.
`extra.prompt_expansion_mode`	enum	`balanced`	`disabled`, `balanced` o `quality`. Omettere l’oggetto o la proprietà mantiene il valore predefinito del modello.
`content_filter`	boolean	`true`	Il filtro dei contenuti di SeedRouter, descritto sotto. Non viene inviato al modello.

Lo schema è rigoroso: i campi sconosciuti vengono rifiutati, non ignorati. callback_url non è disponibile; interroga invece l’attività. extra è un oggetto rigoroso facoltativo che contiene solo prompt_expansion_mode. Tutti i campi rifiutano null; ometti invece quelli facoltativi.

Voci di content

`type`	Voce	`role`
`text`	`{"type":"text","text":"..."}`, fino a 7.000 caratteri	nessuno
`image_url`	`{"type":"image_url","image_url":{"url":"https://..."},"role":"first_frame"}`	`first_frame` o `last_frame`

È richiesto esattamente un elemento di testo non vuoto. Un’immagine singola senza ruolo viene trattata come primo fotogramma. Si accettano al massimo un primo e un ultimo fotogramma; l’ultimo richiede il primo. Immagini, video e audio di riferimento non sono supportati.

Modalità

Gli elementi di content determinano la modalità; non viene inviato alcun campo mode.

Modalità	Contenuto	Rapporto
Da testo a video	un elemento di testo	obbligatorio; uno dei sei rapporti precisi, mai `adaptive`
Da immagine a video	testo e primo fotogramma, ultimo facoltativo	segue i fotogrammi; un altro valore valido non ha effetto

{
  "model": "minimax-h3-max-turbo",
  "content": [
    {"type":"text","text":"Slowly move closer to the ceramic bowl. Keep the glaze and window lighting consistent."},
    {"type":"image_url","image_url":{"url":"https://example.com/first.jpg"},"role":"first_frame"},
    {"type":"image_url","image_url":{"url":"https://example.com/last.jpg"},"role":"last_frame"}
  ],
  "resolution": "480P",
  "duration": 5,
  "ratio": "adaptive",
  "extra": {"prompt_expansion_mode":"balanced"}
}

Fotogrammi

Usa URL HTTP(S) pubblici senza credenziali incorporate. Base64 e ID mm_file:// non sono accettati. Le immagini possono essere JPG, JPEG, PNG, WebP, HEIC o HEIF, massimo 30 MB ciascuna, con lati di 256–5760 pixel e larghezza/altezza tra 0,4 e 2,5. L’input viene controllato prima della generazione. Per due fotogrammi usa composizioni e proporzioni compatibili.

Filtro dei contenuti

content_filter è true a meno che tu non lo imposti diversamente. Con il filtro attivo, la richiesta, con testo e media, viene controllata prima della generazione. Una richiesta segnalata fallisce con il codice 60001 e non viene addebitata. Imposta content_filter su false per saltare il controllo; il Playground del sito lo mantiene sempre attivo.

Fattori di costo

La sezione prezzi del modello mostra le tariffe attuali. Turbo ha un solo costo: secondi di output alla risoluzione scelta. Primo e ultimo fotogramma ed espansione del prompt non hanno costi separati.

cost = reported output seconds × output-second rate for the resolution

La stima usa i secondi interi richiesti. L’addebito finale usa i secondi di output dichiarati dall’attività completata alla tariffa registrata per la richiesta. Se mancano dati di utilizzo validi, si usa la stima accettata. La durata del contenitore multimediale può differire leggermente dai secondi fatturati. Consulta gli addebiti nella cronologia di utilizzo dell’account; le risposte pubbliche delle attività non includono costi. Le attività fallite non vengono addebitate.

Schema di output

L'invio restituisce l'attività:

{"id": "task_...", "model": "minimax-h3-max-turbo", "status": "processing", "created_at": 1789689600}

Recuperare l'attività

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Interroga ogni 10–20 secondi finché status non diventa completed o failed. Un timeout di rete durante il polling non significa che la generazione sia fallita: conserva l'ID attività e riprendi il controllo. Non creare un'altra attività per verificare l'avanzamento.

Attività completata

{
  "id": "task_...",
  "model": "minimax-h3-max-turbo",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689740,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4",
    "resolution": "768P",
    "ratio": "16:9",
    "duration": 5
  }
}

ratio è il rapporto con cui è stata creata la clip, incluso quello scelto per adaptive. L’attività contiene risoluzione, rapporto e durata effettivi quando dichiarati. Il JSON sopra illustra la struttura della risposta; non è un risultato di generazione misurato.

Errori

Le richieste rifiutate prima della creazione di un'attività restituiscono un errore HTTP con un oggetto error e non vengono addebitate. Un'attività che fallisce dopo l'accettazione restituisce HTTP 200 quando viene interrogata, con status: "failed" e un oggetto error.

Vedi il catalogo errori comune per codici, stati HTTP e indicazioni sui tentativi.

{
  "id": "task_...",
  "model": "minimax-h3-max-turbo",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "the request was blocked by content moderation"
  }
}

Se l'invio stesso va in timeout, controlla le tue attività prima di inviare di nuovo: la prima richiesta potrebbe essere stata accettata.

Suggerimenti

Descrivi un soggetto, un’azione, un movimento di camera e un’impostazione di luce per inquadratura.
Usa 480P per una bozza e 768P per più dettagli di output. Ogni nuova generazione è una richiesta a pagamento distinta.
Fornisci un primo fotogramma per definire la composizione iniziale; aggiungi l’ultimo solo quando fornisci anche il primo.
Usa extra.prompt_expansion_mode per scegliere disabled, balanced o quality; l’omissione mantiene balanced.
Controlla l’intera clip e il suo audio prima di pubblicarla. Un prompt non garantisce geometria del prodotto o scritte esatte.

Correlati

Ambito del contratto

Questa interfaccia usa il formato di richiesta MiniMax con array content, ID modello SeedRouter, attività asincrone, immagini solo tramite URL e risultati ospitati. Callback e annullamento non sono disponibili. content_filter è un controllo di input SeedRouter, non un parametro MiniMax.

L’interfaccia separata ospitata da fal ha campi e limiti diversi; i suoi controlli 1080P, durate frazionarie, audio di destinazione e riferimenti ordinati non si applicano qui. Questa interfaccia non accetta controlli di seed e filigrana. Consulta la guida comparativa per la distinzione e le fonti collegate.

On this page