Documentation de l’API MiniMax H3 Fast

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

Tout ce dont vous avez besoin pour appeler MiniMax H3 Fast depuis votre code. URL de base : https://cheapergen.com/api/v1. Essayez d’abord dans l’interface playground.

Vous utilisez un agent de programmation ?

Collez ceci dans Claude Code, Cursor, Codex ou tout autre agent de programmation. Il ajoute l’API à votre projet, conserve la clé dans CHEAPERGEN_API_KEY et teste le devis gratuit avant toute dépense.

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

Ce que votre agent lit

Authentification

Créez une clé dans Tableau de bord → Clés API et envoyez-la comme jeton Bearer. Conservez les clés côté serveur.

export CHEAPERGEN_API_KEY="cg_live_…"

# every request
Authorization: Bearer $CHEAPERGEN_API_KEY

API MiniMax H3 Fast Texte en vidéo

POST/api/v1/run/minimax/h3-fast/text-to-video

Envoie une tâche asynchrone et renvoie 202 avec un ID de génération. Interrogez GET /api/v1/generations/{id} ou indiquez webhook_url. Voir cycle de vie des tâches.

Paramètres d’entrée

Nom	Type	Description	Influe sur le prix
`prompt`requis	string	Décrivez le plan : sujet, action, mouvement de caméra, éclairage et style.	Non
`aspect_ratio`	string (enum)	Format de l’image de sortie. Valeurs : 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 Par défaut : 16:9	Oui
`resolution`	string (enum)	Résolution de sortie. Les résolutions supérieures coûtent plus cher par seconde. Valeurs : 480P · 768P Par défaut : 768P	Oui
`duration`	integer	Durée du clip généré en secondes (4–15 s). La facturation se fait à la seconde. Plage : 4–15s Par défaut : 6	Oui
`seed`	integer	Réutilisez le même seed et les mêmes paramètres pour reproduire un résultat. Laissez ce champ vide pour une valeur aléatoire.	Non
`enable_safety_checker`	boolean	If set to true, the safety checker will be enabled. Content our Acceptable Use Policy prohibits stays blocked either way. Par défaut : true	Non
`webhook_url`	chaîne (URL)	Facultatif. Nous envoyons la génération terminée par POST à cette adresse, avec une signature calculée à l’aide de votre secret de webhook. Webhooks	Non

Requête

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": "Un bateau en papier dérive dans une gouttière pleine de pluie au crépuscule, pluie fine et cloche lointaine d’un tramway",
    "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": "Un bateau en papier dérive dans une gouttière pleine de pluie au crépuscule, pluie fine et cloche lointaine d’un tramway",
    "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": "Un bateau en papier dérive dans une gouttière pleine de pluie au crépuscule, pluie fine et cloche lointaine d’un tramway",
  "aspect_ratio": "16:9",
  "resolution": "768P",
  "duration": 6
}'

Réponse

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "minimax/h3-fast",
  "endpoint": "minimax/h3-fast/text-to-video",
  "mode": "text-to-video",
  "status": "queued",
  "input": {
    "prompt": "Un bateau en papier dérive dans une gouttière pleine de pluie au crépuscule, pluie fine et cloche lointaine d’un tramway",
    "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": "Un bateau en papier dérive dans une gouttière pleine de pluie au crépuscule, pluie fine et cloche lointaine d’un tramway",
    "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 Image en vidéo

POST/api/v1/run/minimax/h3-fast/image-to-video

Envoie une tâche asynchrone et renvoie 202 avec un ID de génération. Interrogez GET /api/v1/generations/{id} ou indiquez webhook_url. Voir cycle de vie des tâches.

Paramètres d’entrée

Nom	Type	Description	Influe sur le prix
`prompt`requis	string	Décrivez le plan : sujet, action, mouvement de caméra, éclairage et style.	Non
`image_url`requis	string (URL)	Image utilisée comme première image. JPG/PNG/WebP, URL ou téléversement.	Non
`end_image_url`	string (URL)	Image de fin facultative : le modèle anime la transition entre les deux images.	Non
`aspect_ratio`	string (enum)	Format de l’image de sortie. Choisissez celui qui correspond le mieux à votre première image. Valeurs : 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 Par défaut : 16:9	Oui
`resolution`	string (enum)	Résolution de sortie. Les résolutions supérieures coûtent plus cher par seconde. Valeurs : 480P · 768P Par défaut : 768P	Oui
`duration`	integer	Durée du clip généré en secondes (4–15 s). La facturation se fait à la seconde. Plage : 4–15s Par défaut : 6	Oui
`seed`	integer	Réutilisez le même seed et les mêmes paramètres pour reproduire un résultat. Laissez ce champ vide pour une valeur aléatoire.	Non
`enable_safety_checker`	boolean	If set to true, the safety checker will be enabled. Content our Acceptable Use Policy prohibits stays blocked either way. Par défaut : true	Non
`webhook_url`	chaîne (URL)	Facultatif. Nous envoyons la génération terminée par POST à cette adresse, avec une signature calculée à l’aide de votre secret de webhook. Webhooks	Non

Requête

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": "La fleur s’ouvre lentement dans la lumière du matin, chant d’oiseaux en arrière-plan",
    "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": "La fleur s’ouvre lentement dans la lumière du matin, chant d’oiseaux en arrière-plan",
    "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": "La fleur s’ouvre lentement dans la lumière du matin, chant d’oiseaux en arrière-plan",
  "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
  "aspect_ratio": "16:9",
  "resolution": "768P",
  "duration": 6
}'

Réponse

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "minimax/h3-fast",
  "endpoint": "minimax/h3-fast/image-to-video",
  "mode": "image-to-video",
  "status": "queued",
  "input": {
    "prompt": "La fleur s’ouvre lentement dans la lumière du matin, chant d’oiseaux en arrière-plan",
    "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": "La fleur s’ouvre lentement dans la lumière du matin, chant d’oiseaux en arrière-plan",
    "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 Référence → vidéo

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

Envoie une tâche asynchrone et renvoie 202 avec un ID de génération. Interrogez GET /api/v1/generations/{id} ou indiquez webhook_url. Voir cycle de vie des tâches.

Paramètres d’entrée

Nom	Type	Description	Influe sur le prix
`prompt`requis	string	Décrivez le plan : sujet, action, mouvement de caméra, éclairage et style.	Non
`reference_image_urls`	string[] (URLs)	Jusqu’à 9 images pour les personnages, les produits, les styles ou les scènes. Mentionnez-les avec @Image1, @Image2… Les 5 premières sont incluses ; chaque image supplémentaire entraîne un petit supplément. Nombre maximal d’éléments : 9	Non
`reference_video_urls`	string[] (video URLs)	Jusqu’à 3 clips MP4/MOV pour les mouvements, déplacements de caméra ou effets (2–15 s chacune, 15 s au total, ≤ 50 MB chacune). Mentionnez-les avec @Video1, @Video2… Les secondes des vidéos de référence sont facturées au même tarif que celles du résultat. Nombre maximal d’éléments : 3	Oui
`reference_audio_urls`	string[] (audio URLs)	Jusqu’à 3 clips MP3/WAV pour la voix, la musique ou le son (2–15 s chacune, 15 s au total, ≤ 15 MB chacune). Mentionnez-les avec @Audio1, @Audio2… Nécessite au moins une image ou une vidéo de référence. Nombre maximal d’éléments : 3	Non
`aspect_ratio`	string (enum)	Format de l’image de sortie. Valeurs : 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 Par défaut : 16:9	Oui
`resolution`	string (enum)	Résolution de sortie. Les résolutions supérieures coûtent plus cher par seconde. Valeurs : 480P · 768P Par défaut : 768P	Oui
`duration`	integer	Durée du clip généré en secondes (4–15 s). La facturation se fait à la seconde. Plage : 4–15s Par défaut : 6	Oui
`seed`	integer	Réutilisez le même seed et les mêmes paramètres pour reproduire un résultat. Laissez ce champ vide pour une valeur aléatoire.	Non
`enable_safety_checker`	boolean	If set to true, the safety checker will be enabled. Content our Acceptable Use Policy prohibits stays blocked either way. Par défaut : true	Non
`webhook_url`	chaîne (URL)	Facultatif. Nous envoyons la génération terminée par POST à cette adresse, avec une signature calculée à l’aide de votre secret de webhook. Webhooks	Non

Requête

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": "Le chanteur de @Image1 se produit sur le toit, en suivant le mouvement de caméra de @Video1, avec les voix de @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": "Le chanteur de @Image1 se produit sur le toit, en suivant le mouvement de caméra de @Video1, avec les voix de @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": "Le chanteur de @Image1 se produit sur le toit, en suivant le mouvement de caméra de @Video1, avec les voix de @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
}'

Réponse

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "minimax/h3-fast",
  "endpoint": "minimax/h3-fast/reference-to-video",
  "mode": "reference-to-video",
  "status": "queued",
  "input": {
    "prompt": "Le chanteur de @Image1 se produit sur le toit, en suivant le mouvement de caméra de @Video1, avec les voix de @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": "Le chanteur de @Image1 se produit sur le toit, en suivant le mouvement de caméra de @Video1, avec les voix de @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"
}

Récupérer le résultat

Les générations sont asynchrones. Interrogez leur état jusqu’à ce que status soit succeeded, failed ou canceled, ou indiquez webhook_url lors de l’envoi. Les générations échouées sont automatiquement remboursées.

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

Pour en savoir plus : cycle de vie des tâches · webhooks · erreurs

Tarifs de MiniMax H3 Fast

Payez par seconde de vidéo à l’usage, sans abonnement requis. Les générations échouées sont remboursées automatiquement.

Offre	API officielle de MiniMax H3	CheaperGen	Vous économisez
480P par seconde · audio inclus · par rapport à MiniMax H3 Max 480P	~~$0,05~~/s	$0,0369/s Avec un forfait mensuel : Pro $0,0352Max $0,0335	−26%
768P par seconde · audio inclus · par rapport à MiniMax H3 768P	~~$0,08~~/s	$0,0546/s Avec un forfait mensuel : Pro $0,0518Max $0,049	−32%

Forfaits mensuels vous fait bénéficier de tarifs réduits sur la plupart des modèles (indiqués sous chaque prix), tout en gardant le paiement à l’usage. Pro $499/mois · Max $4 999/mois.

API officielle de MiniMax H3 : Prix catalogue de l’API officielle MiniMax H3 à la même résolution, sur platform.minimax.io (MiniMax ne vend pas H3 Fast, référence utilisée ici : MiniMax H3 en 768P à $0.08 / s ; en 480P, MiniMax H3 Max 480P à $0.05 / s, seul palier H3 officiel MiniMax en 480P). Tarifs vérifiés le 18 octobre 2026.
En conversion de référence en vidéo, les secondes des vidéos de référence sont facturées comme celles du résultat ; les 5 premières images de référence sont incluses, chaque image supplémentaire coûte environ le prix d’une seconde ; les premières/dernières images et l’audio de référence sont gratuits.
Version accélérée : le prix barré correspond au tarif de l’API officielle MiniMax H3 à la même résolution (H3 en 768P, H3 Max en 480P). MiniMax ne propose pas H3 Fast.