MiniMax H3 Max

MiniMax H3 Max è la variante a generazione più rapida di MiniMax H3. Una richiesta crea immagine e audio insieme: una clip di 5–15 secondi a 480P o 768P con dialoghi, ambiente ed effetti propri. Il corpo della richiesta segue il formato ufficiale MiniMax con l’ID modello minimax-h3-max. Invialo, conserva l’ID attività restituito e recupera il video finito dall’attività. Fotogrammi e riferimenti vengono passati come URL.

ID modello

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",
    "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

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

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

Una singola immagine senza role è il primo fotogramma. Con più di un'immagine, ogni immagine richiede un role.

Modalità

Sono le voci in content a determinare la modalità; non esiste un campo per la modalità.

Fotogrammi e riferimenti non si possono combinare in una richiesta. La documentazione ufficiale elenca l’input con il solo ultimo fotogramma, ma contiene anche il requisito contraddittorio di abbinarlo a un primo fotogramma. Questo caso non è stato verificato su SeedRouter. Usa entrambi i fotogrammi quando serve un’immagine finale.

{
  "model": "minimax-h3-max",
  "content": [
    {"type": "text", "text": "The person in the photo speaks to camera: Follow the wind. Voice follows the reference audio."},
    {"type": "image_url", "image_url": {"url": "https://example.com/person.jpg"}, "role": "reference_image"},
    {"type": "audio_url", "audio_url": {"url": "https://example.com/voice.mp3"}, "role": "reference_audio"}
  ],
  "resolution": "768P",
  "duration": 6
}

Input multimediali

Ogni voce di immagine, video e audio è un URL HTTP(S) pubblico. Data URI in base64 e ID mm_file:// non sono accettati: carica il file nel tuo storage e passa il suo URL.

I video di riferimento vengono misurati quando la richiesta è accettata; un video di cui non si riesce a leggere la durata viene rifiutato senza alcun addebito. Gli altri limiti vengono controllati prima della generazione, e una richiesta che ne viola uno fallisce senza addebito.

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

Consulta la sezione prezzi del modello per le tariffe attuali. MiniMax H3 Max addebita separatamente secondi di output generati e secondi di video di riferimento, secondo la risoluzione di output. Le prime due immagini sono gratuite; ogni immagine successiva aggiunge un costo.

output seconds = reported generated seconds
input seconds  = reported reference-video seconds
extra images   = max(0, reported input image count − 2)
cost = output seconds × output rate
     + input seconds × reference-video rate
     + extra images × image rate

Le durate dei video di riferimento vengono sommate e arrotondate al secondo intero più vicino per l’utilizzo finale. Due clip di 2,4 secondi corrispondono quindi a cinque secondi di input. L’audio di riferimento non ha costi di input. Primo e ultimo fotogramma contano come immagini: due fotogrammi da soli non aggiungono quindi costi di immagine.

La stima del Playground arrotonda per eccesso le durate dei video di riferimento per coprire il possibile costo finale. L’utilizzo finale viene addebitato alla tariffa registrata per la richiesta. Se manca un resoconto completo dell’utilizzo, si usa la stima accettata. 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", "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",
  "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",
  "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 insieme l'inquadratura e il suo audio: soggetto, luogo, camera, luce, dialoghi ed effetti.
• Scrivi i dialoghi nel prompt e allega una clip audio di riferimento quando la voce deve seguirla.
• Crea una bozza a 480P, poi scegli 768P quando servono più dettagli. Ogni nuova generazione è una richiesta a pagamento distinta.
• Usa extra: {"prompt_expansion_mode": "disabled"} per un prompt già completo, oppure scegli l’espansione balanced / quality.
• Usa un primo e un ultimo fotogramma per controllare dove inizia e finisce un'inquadratura; usa i riferimenti per mantenere un prodotto, una persona o un movimento.
• Aggiungi no text, no logos per evitare marchi inventati.

Correlati

• Playground e prezzi di MiniMax H3 Max
• Scarica OpenAPI
• Markdown da copiare

Fonti del contratto

I parametri seguono la documentazione MiniMax sulla generazione video. SeedRouter usa il proprio ID modello, attività asincrone, media solo tramite URL e risultati ospitati; callback e annullamento non sono disponibili. content_filter è un’estensione SeedRouter.