MiniMaxVideo

API MiniMax H3 Da riferimento a video

Name: API MiniMax H3
Brand: MiniMax
SKU: minimax/h3
Availability: InStock

Da riferimento a video con MiniMax H3 di MiniMax. Hailuo H3 — movimenti espressivi e fisica realistica, fino a 2K.

minimax/h3/reference-to-video

DaFino al −29%

$0.057/s$0,08

al secondo di video · 768P

Con Max: da $0.055/s →Operativo100% disponibilità operativa (30 giorni)mediana 3m 37s

Crea con MiniMax H3 Ottieni una chiave API

Documentazione API →Confronta i modelli →

Prova MiniMax H3 Da riferimento a video

Prompt*

Digita @ per fare riferimento a Immagine, Video o Audio0/5000

Immagini di riferimento

Fino a 5 immagini per definire personaggi, prodotti, stile o scena. Richiamale nel prompt con @Image1, @Image2…

Video di riferimento

Fino a 3 clip MP4/MOV per movimenti, movimenti di camera o effetti (2–15 s ciascuno, 15 s in totale, ≤ 50 MB ciascuno). Richiamale con @Video1, @Video2… I secondi dei video di riferimento vengono fatturati come i secondi di output.

Audio di riferimento

Fino a 3 clip MP3/WAV per voce, musica o suoni (2–15 s ciascuno, 15 s in totale, ≤ 15 MB ciascuno). Richiamale con @Audio1, @Audio2… Serve almeno un’immagine o un video di riferimento.

Proporzioni

Formato del fotogramma in output.

Risoluzione

Risoluzione dell’output. Le risoluzioni più alte costano di più al secondo.

Durata

Durata della clip generata in secondi (5–15 s). Paghi al secondo.

Costo stimato…

Crea un account gratuito con Google o email e paga solo ciò che generi.

Il tuo Video apparirà qui

Scrivi un prompt, scegli le impostazioni e premi Esegui. Paghi solo le generazioni riuscite.

Disponibile anche: MiniMax H3 Da testo a video · MiniMax H3 Da immagine a video

Vedi gli esempi e i prompt di MiniMax H3

API MiniMax H3 Da riferimento a video

POST/api/v1/run/minimax/h3/reference-to-video

Invia un job asincrono e restituisce 202 con l’ID della generazione. Interroga GET /api/v1/generations/{id} o specifica webhook_url. Consulta il ciclo di vita dei job.

Parametri di input

Nome	Tipo	Descrizione	Effetto sul prezzo
`prompt`obbligatorio	string	Descrivi l’inquadratura: soggetto, azione, movimento della camera, illuminazione e stile.	No
`reference_image_urls`	string[] (URLs)	Fino a 5 immagini per definire personaggi, prodotti, stile o scena. Richiamale nel prompt con @Image1, @Image2… Numero massimo di elementi: 5	No
`reference_video_urls`	string[] (video URLs)	Fino a 3 clip MP4/MOV per movimenti, movimenti di camera o effetti (2–15 s ciascuno, 15 s in totale, ≤ 50 MB ciascuno). Richiamale con @Video1, @Video2… I secondi dei video di riferimento vengono fatturati come i secondi di output. Numero massimo di elementi: 3	Sì
`reference_audio_urls`	string[] (audio URLs)	Fino a 3 clip MP3/WAV per voce, musica o suoni (2–15 s ciascuno, 15 s in totale, ≤ 15 MB ciascuno). Richiamale con @Audio1, @Audio2… Serve almeno un’immagine o un video di riferimento. Numero massimo di elementi: 3	No
`aspect_ratio`	string (enum)	Formato del fotogramma in output. Valori: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 Predefinito: 16:9	Sì
`resolution`	string (enum)	Risoluzione dell’output. Le risoluzioni più alte costano di più al secondo. Valori: 768P · 2K Predefinito: 768P	Sì
`duration`	integer	Durata della clip generata in secondi (5–15 s). Paghi al secondo. Intervallo: 5–15s Predefinito: 6	Sì
`seed`	integer	Usa lo stesso seed e le stesse impostazioni per riprodurre un risultato. Lascia vuoto per un valore casuale.	No
`webhook_url`	stringa (URL)	Facoltativo. Inviamo con POST la generazione completata a questo indirizzo, firmandola con il segreto del webhook. Webhook	No

Richiesta

const API = "https://cheapergen.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Submit the job
let job = await fetch(`${API}/run/minimax/h3/reference-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "La mascotte di @Image1 balla davanti al negozio di @Image2, seguendo i movimenti di @Video1",
    "reference_image_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.jpg",
      "https://cdn.cheapergen.com/samples/reference-2.jpg"
    ],
    "reference_video_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.mp4"
    ],
    "aspect_ratio": "16:9",
    "resolution": "768P",
    "duration": 6
  }),
}).then((r) => r.json());

// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 3000));
  job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}

console.log(job.status === "succeeded" ? job.output.video.url : job.error);

import os, time, requests

API = "https://cheapergen.com/api/v1"
headers = {"Authorization": f"Bearer {os.environ['CHEAPERGEN_API_KEY']}"}

# 1. Submit the job
job = requests.post(f"{API}/run/minimax/h3/reference-to-video", headers=headers, json={
    "prompt": "La mascotte di @Image1 balla davanti al negozio di @Image2, seguendo i movimenti di @Video1",
    "reference_image_urls": [
        "https://cdn.cheapergen.com/samples/reference-1.jpg",
        "https://cdn.cheapergen.com/samples/reference-2.jpg"
    ],
    "reference_video_urls": [
        "https://cdn.cheapergen.com/samples/reference-1.mp4"
    ],
    "aspect_ratio": "16:9",
    "resolution": "768P",
    "duration": 6
}).json()

# 2. Poll until it finishes (or pass "webhook_url" and skip polling)
while job["status"] in ("queued", "running"):
    time.sleep(3)
    job = requests.get(f"{API}/generations/{job['id']}", headers=headers).json()

print(job["status"], job["output"]["video"]["url"] if job["status"] == "succeeded" else job["error"])

curl -X POST https://cheapergen.com/api/v1/run/minimax/h3/reference-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "La mascotte di @Image1 balla davanti al negozio di @Image2, seguendo i movimenti di @Video1",
  "reference_image_urls": [
    "https://cdn.cheapergen.com/samples/reference-1.jpg",
    "https://cdn.cheapergen.com/samples/reference-2.jpg"
  ],
  "reference_video_urls": [
    "https://cdn.cheapergen.com/samples/reference-1.mp4"
  ],
  "aspect_ratio": "16:9",
  "resolution": "768P",
  "duration": 6
}'

Risposta

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "minimax/h3",
  "endpoint": "minimax/h3/reference-to-video",
  "mode": "reference-to-video",
  "status": "queued",
  "input": {
    "prompt": "La mascotte di @Image1 balla davanti al negozio di @Image2, seguendo i movimenti di @Video1",
    "reference_image_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.jpg",
      "https://cdn.cheapergen.com/samples/reference-2.jpg"
    ],
    "reference_video_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.mp4"
    ],
    "aspect_ratio": "16:9",
    "resolution": "768P",
    "duration": 6
  },
  "output": null,
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": true,
    "official_usd": null,
    "list_price_source": "official",
    "list_price_label": "Official",
    "saved_usd": null
  },
  "source": "api",
  "started_at": null,
  "completed_at": null,
  "urls": {
    "get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
    "cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
  },
  "created_at": "2026-10-15T09:21:04Z"
}

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "minimax/h3",
  "endpoint": "minimax/h3/reference-to-video",
  "mode": "reference-to-video",
  "status": "succeeded",
  "input": {
    "prompt": "La mascotte di @Image1 balla davanti al negozio di @Image2, seguendo i movimenti di @Video1",
    "reference_image_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.jpg",
      "https://cdn.cheapergen.com/samples/reference-2.jpg"
    ],
    "reference_video_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.mp4"
    ],
    "aspect_ratio": "16:9",
    "resolution": "768P",
    "duration": 6
  },
  "output": {
    "video": {
      "url": "https://cdn.cheapergen.com/outputs/gen_8c2Q.mp4",
      "content_type": "video/mp4",
      "duration": 5,
      "width": 1280,
      "height": 720
    }
  },
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": false,
    "official_usd": 0.264,
    "list_price_source": "official",
    "list_price_label": "Official",
    "saved_usd": 0.0385
  },
  "source": "api",
  "created_at": "2026-10-15T09:21:04Z",
  "started_at": "2026-10-15T09:21:06Z",
  "completed_at": "2026-10-15T09:22:31Z"
}

prezzi di MiniMax H3

Paga al secondo di video man mano che le usi, senza abbonamento. Le generazioni non riuscite vengono rimborsate automaticamente.

Fascia	Prezzo ufficiale	CheaperGen	Risparmi
768P al secondo	~~$0,08~~/s	$0,057/s Con un piano mensile: Pro $0,0557Max $0,0544	−29%
2K al secondo	~~$0,13~~/s	$0,1068/s Con un piano mensile: Pro $0,1033Max $0,0998	−18%

Piani mensili prezzi più bassi sulla maggior parte dei modelli (indicati sotto ogni prezzo); puoi continuare a pagare a consumo. Pro $499/mese · Max $4999/mese.

Prezzo ufficiale: Prezzo di listino dell’API internazionale MiniMax, platform.minimax.io ($0.08 / s a 768P, $0.13 / s a 2K; i secondi dei video di riferimento sono fatturati alla tariffa dell’output, l’audio di riferimento è gratuito). Prezzi verificati il 18 ottobre 2026.
I secondi dei video di riferimento sono fatturati alla tariffa dell’output; l’audio di riferimento è gratuito.