Documentazione API di MiniMax H3 Fast

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

Tutto ciò che ti serve per chiamare MiniMax H3 Fast dal tuo codice. URL di base: https://cheapergen.com/api/v1. Provalo prima nel playground.

Usi un agente di programmazione?

Incolla questo testo in Claude Code, Cursor, Codex o qualsiasi agente di programmazione. Aggiunge l’API al tuo progetto, conserva la chiave in CHEAPERGEN_API_KEY ed esegue una prova con un preventivo gratuito prima di spendere.

Add MiniMax H3 Fast (CheaperGen endpoint minimax/h3-fast/text-to-video) to this project by following https://cheapergen.com/agents/integrate.md

Cosa legge il tuo agente

Autenticazione

Crea una chiave in Dashboard → Chiavi API, inviala come token bearer e conservala lato server.

export CHEAPERGEN_API_KEY="cg_live_…"

# every request
Authorization: Bearer $CHEAPERGEN_API_KEY

API MiniMax H3 Fast Da testo a video

POST/api/v1/run/minimax/h3-fast/text-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
`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: 480P · 768P Predefinito: 768P	Sì
`duration`	integer	Durata della clip generata in secondi (4–15 s). Paghi al secondo. Intervallo: 4–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
`enable_safety_checker`	boolean	If set to true, the safety checker will be enabled. Content our Acceptable Use Policy prohibits stays blocked either way. Predefinito: true	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-fast/text-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "Una barchetta di carta scivola lungo una cunetta piena di pioggia al crepuscolo, lo scroscio della pioggia e il campanello di un tram in lontananza",
    "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-fast/text-to-video", headers=headers, json={
    "prompt": "Una barchetta di carta scivola lungo una cunetta piena di pioggia al crepuscolo, lo scroscio della pioggia e il campanello di un tram in lontananza",
    "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-fast/text-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "Una barchetta di carta scivola lungo una cunetta piena di pioggia al crepuscolo, lo scroscio della pioggia e il campanello di un tram in lontananza",
  "aspect_ratio": "16:9",
  "resolution": "768P",
  "duration": 6
}'

Risposta

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "minimax/h3-fast",
  "endpoint": "minimax/h3-fast/text-to-video",
  "mode": "text-to-video",
  "status": "queued",
  "input": {
    "prompt": "Una barchetta di carta scivola lungo una cunetta piena di pioggia al crepuscolo, lo scroscio della pioggia e il campanello di un tram in lontananza",
    "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": "reference",
    "list_price_label": "Official MiniMax H3 API",
    "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-fast",
  "endpoint": "minimax/h3-fast/text-to-video",
  "mode": "text-to-video",
  "status": "succeeded",
  "input": {
    "prompt": "Una barchetta di carta scivola lungo una cunetta piena di pioggia al crepuscolo, lo scroscio della pioggia e il campanello di un tram in lontananza",
    "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": "reference",
    "list_price_label": "Official MiniMax H3 API",
    "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"
}

API MiniMax H3 Fast Da immagine a video

POST/api/v1/run/minimax/h3-fast/image-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
`image_url`obbligatorio	string (URL)	Immagine usata come fotogramma iniziale. JPG/PNG/WebP, URL o caricamento.	No
`end_image_url`	string (URL)	Fotogramma conclusivo facoltativo: il modello anima la transizione tra i due.	No
`aspect_ratio`	string (enum)	Formato dei fotogrammi in output. Scegli quello più simile al primo fotogramma. 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: 480P · 768P Predefinito: 768P	Sì
`duration`	integer	Durata della clip generata in secondi (4–15 s). Paghi al secondo. Intervallo: 4–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
`enable_safety_checker`	boolean	If set to true, the safety checker will be enabled. Content our Acceptable Use Policy prohibits stays blocked either way. Predefinito: true	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-fast/image-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "Il fiore si apre lentamente nella luce del mattino, con il canto degli uccelli in sottofondo",
    "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
    "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-fast/image-to-video", headers=headers, json={
    "prompt": "Il fiore si apre lentamente nella luce del mattino, con il canto degli uccelli in sottofondo",
    "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
    "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-fast/image-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "Il fiore si apre lentamente nella luce del mattino, con il canto degli uccelli in sottofondo",
  "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
  "aspect_ratio": "16:9",
  "resolution": "768P",
  "duration": 6
}'

Risposta

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "minimax/h3-fast",
  "endpoint": "minimax/h3-fast/image-to-video",
  "mode": "image-to-video",
  "status": "queued",
  "input": {
    "prompt": "Il fiore si apre lentamente nella luce del mattino, con il canto degli uccelli in sottofondo",
    "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
    "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": "reference",
    "list_price_label": "Official MiniMax H3 API",
    "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-fast",
  "endpoint": "minimax/h3-fast/image-to-video",
  "mode": "image-to-video",
  "status": "succeeded",
  "input": {
    "prompt": "Il fiore si apre lentamente nella luce del mattino, con il canto degli uccelli in sottofondo",
    "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
    "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": "reference",
    "list_price_label": "Official MiniMax H3 API",
    "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"
}

API MiniMax H3 Fast Da riferimento a video

POST/api/v1/run/minimax/h3-fast/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 9 immagini per definire personaggi, prodotti, stile o scena. Richiamale con @Image1, @Image2… Le prime 5 sono incluse; ogni immagine aggiuntiva comporta un piccolo costo. Numero massimo di elementi: 9	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: 480P · 768P Predefinito: 768P	Sì
`duration`	integer	Durata della clip generata in secondi (4–15 s). Paghi al secondo. Intervallo: 4–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
`enable_safety_checker`	boolean	If set to true, the safety checker will be enabled. Content our Acceptable Use Policy prohibits stays blocked either way. Predefinito: true	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-fast/reference-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "Il cantante di @Image1 si esibisce sul tetto, seguendo il movimento della camera in @Video1, con la voce di @Audio1",
    "reference_image_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.jpg"
    ],
    "reference_video_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.mp4"
    ],
    "reference_audio_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.mp3"
    ],
    "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-fast/reference-to-video", headers=headers, json={
    "prompt": "Il cantante di @Image1 si esibisce sul tetto, seguendo il movimento della camera in @Video1, con la voce di @Audio1",
    "reference_image_urls": [
        "https://cdn.cheapergen.com/samples/reference-1.jpg"
    ],
    "reference_video_urls": [
        "https://cdn.cheapergen.com/samples/reference-1.mp4"
    ],
    "reference_audio_urls": [
        "https://cdn.cheapergen.com/samples/reference-1.mp3"
    ],
    "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-fast/reference-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "Il cantante di @Image1 si esibisce sul tetto, seguendo il movimento della camera in @Video1, con la voce di @Audio1",
  "reference_image_urls": [
    "https://cdn.cheapergen.com/samples/reference-1.jpg"
  ],
  "reference_video_urls": [
    "https://cdn.cheapergen.com/samples/reference-1.mp4"
  ],
  "reference_audio_urls": [
    "https://cdn.cheapergen.com/samples/reference-1.mp3"
  ],
  "aspect_ratio": "16:9",
  "resolution": "768P",
  "duration": 6
}'

Risposta

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "minimax/h3-fast",
  "endpoint": "minimax/h3-fast/reference-to-video",
  "mode": "reference-to-video",
  "status": "queued",
  "input": {
    "prompt": "Il cantante di @Image1 si esibisce sul tetto, seguendo il movimento della camera in @Video1, con la voce di @Audio1",
    "reference_image_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.jpg"
    ],
    "reference_video_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.mp4"
    ],
    "reference_audio_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.mp3"
    ],
    "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": "reference",
    "list_price_label": "Official MiniMax H3 API",
    "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-fast",
  "endpoint": "minimax/h3-fast/reference-to-video",
  "mode": "reference-to-video",
  "status": "succeeded",
  "input": {
    "prompt": "Il cantante di @Image1 si esibisce sul tetto, seguendo il movimento della camera in @Video1, con la voce di @Audio1",
    "reference_image_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.jpg"
    ],
    "reference_video_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.mp4"
    ],
    "reference_audio_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.mp3"
    ],
    "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": "reference",
    "list_price_label": "Official MiniMax H3 API",
    "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"
}

Ottieni il risultato

Le generazioni sono asincrone. Continua a interrogare finché il campo status non vale succeeded, failed o canceled; oppure specifica webhook_url al momento dell’invio. Le generazioni non riuscite vengono rimborsate automaticamente.

curl https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4 \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY"

Altro: ciclo di vita dei job · i webhook · errori

prezzi di MiniMax H3 Fast

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

Fascia	API ufficiale MiniMax H3	CheaperGen	Risparmi
480P al secondo · audio incluso · rispetto a MiniMax H3 Max 480P	~~$0,05~~/s	$0,0369/s Con un piano mensile: Pro $0,0352Max $0,0335	−26%
768P al secondo · audio incluso · rispetto a MiniMax H3 768P	~~$0,08~~/s	$0,0546/s Con un piano mensile: Pro $0,0518Max $0,049	−32%

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.

API ufficiale MiniMax H3: Prezzo dell’API ufficiale H3 di MiniMax alla stessa risoluzione, platform.minimax.io (MiniMax non vende H3 Fast, quindi questo è il riferimento: MiniMax H3 768P $0.08 / s; a 480P, MiniMax H3 Max 480P $0.05 / s, l’unico livello ufficiale H3 di MiniMax a 480P). Prezzi verificati il 18 ottobre 2026.
Nella conversione da video di riferimento, i secondi del video di riferimento sono fatturati come quelli di output; le prime 5 immagini di riferimento sono incluse, ogni immagine aggiuntiva costa circa quanto un secondo; il primo e l’ultimo fotogramma e l’audio di riferimento sono gratuiti.
Variante accelerata: il prezzo barrato è quello dell’API ufficiale MiniMax H3 alla stessa risoluzione (H3 a 768P, H3 Max a 480P). MiniMax non ha un prezzo per H3 Fast.