MiniMax H3 Fast-API-Dokumentation
Alles, was Sie benötigen, um MiniMax H3 Fast aus Ihrem Code aufzurufen. Basis-URL: https://cheapergen.com/api/v1. Probieren Sie es zuerst in Playground aus.
Verwenden Sie einen Coding-Agenten?
Fügen Sie dies in Claude Code, Cursor, Codex oder einen beliebigen Coding-Agenten ein. Er bindet die API in Ihr Projekt ein, speichert den Schlüssel in CHEAPERGEN_API_KEY und prüft den Preis kostenlos, bevor Kosten entstehen.
Add MiniMax H3 Fast (CheaperGen endpoint minimax/ h3-fast/ text-to-video) to this project by following https:/ / cheapergen.com/ agents/ integrate.mdAuthentifizierung
Erstellen Sie in Dashboard → API keys einen Schlüssel und senden Sie ihn als Bearer-Token mit. Bewahren Sie Schlüssel ausschließlich auf Ihrem Server auf.
export CHEAPERGEN_API_KEY="cg_live_…"
# every request
Authorization: Bearer $CHEAPERGEN_API_KEYMiniMax H3 Fast Text zu Video-API
/api/v1/run/minimax/h3-fast/text-to-videoÜbermittelt einen asynchronen Auftrag und gibt 202 mit einer Generierungs-ID zurück. Fragen Sie GET /api/v1/generations/{id} ab oder übergeben Sie webhook_url. Siehe Ablauf eines Auftrags.
Eingabeparameter
| Name | Typ | Beschreibung | Beeinflusst den Preis |
|---|---|---|---|
prompterforderlich | string | Beschreiben Sie Motiv, Handlung, Kamerabewegung, Beleuchtung und Stil. | Kein |
aspect_ratio | string (enum) | Format des Ausgabebilds. Werte: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 Standard: 16:9 | Ja |
resolution | string (enum) | Ausgabeauflösung. Höhere Auflösungen kosten pro Sekunde mehr. Werte: 480P · 768P Standard: 768P | Ja |
duration | integer | Länge des generierten Clips in Sekunden (4–15 s). Abrechnung pro Sekunde. Bereich: 4–15s Standard: 6 | Ja |
seed | integer | Verwenden Sie denselben Seed und dieselben Einstellungen, um ein Ergebnis zu reproduzieren. Leer lassen für Zufallswerte. | Kein |
enable_safety_checker | boolean | If set to true, the safety checker will be enabled. Content our Acceptable Use Policy prohibits stays blocked either way. Standard: true | Kein |
webhook_url | Zeichenfolge (URL) | Optional. Wir senden die abgeschlossene Generierung per POST an diese URL und signieren die Anfrage mit Ihrem Webhook-Schlüssel. Webhooks | Kein |
Anfrage
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": "Ein Papierboot treibt bei Dämmerung eine regengefüllte Rinne hinunter, Regenprasseln und eine ferne Straßenbahnglocke",
"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);Antwort
{
"id": "gen_8c2QmX1nq0k4",
"object": "generation",
"model": "minimax/h3-fast",
"endpoint": "minimax/h3-fast/text-to-video",
"mode": "text-to-video",
"status": "queued",
"input": {
"prompt": "Ein Papierboot treibt bei Dämmerung eine regengefüllte Rinne hinunter, Regenprasseln und eine ferne Straßenbahnglocke",
"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"
}MiniMax H3 Fast Bild zu Video-API
/api/v1/run/minimax/h3-fast/image-to-videoÜbermittelt einen asynchronen Auftrag und gibt 202 mit einer Generierungs-ID zurück. Fragen Sie GET /api/v1/generations/{id} ab oder übergeben Sie webhook_url. Siehe Ablauf eines Auftrags.
Eingabeparameter
| Name | Typ | Beschreibung | Beeinflusst den Preis |
|---|---|---|---|
prompterforderlich | string | Beschreiben Sie Motiv, Handlung, Kamerabewegung, Beleuchtung und Stil. | Kein |
image_urlerforderlich | string (URL) | Bild für das erste Einzelbild. JPG/PNG/WebP, URL oder Upload. | Kein |
end_image_url | string (URL) | Optionales Schlussbild – das Modell animiert den Übergang zwischen beiden. | Kein |
aspect_ratio | string (enum) | Format des Ausgabebilds. Wählen Sie das Format, das Ihrem Startbild am nächsten kommt. Werte: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 Standard: 16:9 | Ja |
resolution | string (enum) | Ausgabeauflösung. Höhere Auflösungen kosten pro Sekunde mehr. Werte: 480P · 768P Standard: 768P | Ja |
duration | integer | Länge des generierten Clips in Sekunden (4–15 s). Abrechnung pro Sekunde. Bereich: 4–15s Standard: 6 | Ja |
seed | integer | Verwenden Sie denselben Seed und dieselben Einstellungen, um ein Ergebnis zu reproduzieren. Leer lassen für Zufallswerte. | Kein |
enable_safety_checker | boolean | If set to true, the safety checker will be enabled. Content our Acceptable Use Policy prohibits stays blocked either way. Standard: true | Kein |
webhook_url | Zeichenfolge (URL) | Optional. Wir senden die abgeschlossene Generierung per POST an diese URL und signieren die Anfrage mit Ihrem Webhook-Schlüssel. Webhooks | Kein |
Anfrage
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": "Die Blume öffnet sich langsam im Morgenlicht, Vogelgesang im Hintergrund",
"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);Antwort
{
"id": "gen_8c2QmX1nq0k4",
"object": "generation",
"model": "minimax/h3-fast",
"endpoint": "minimax/h3-fast/image-to-video",
"mode": "image-to-video",
"status": "queued",
"input": {
"prompt": "Die Blume öffnet sich langsam im Morgenlicht, Vogelgesang im Hintergrund",
"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"
}MiniMax H3 Fast Referenz zu Video-API
/api/v1/run/minimax/h3-fast/reference-to-videoÜbermittelt einen asynchronen Auftrag und gibt 202 mit einer Generierungs-ID zurück. Fragen Sie GET /api/v1/generations/{id} ab oder übergeben Sie webhook_url. Siehe Ablauf eines Auftrags.
Eingabeparameter
| Name | Typ | Beschreibung | Beeinflusst den Preis |
|---|---|---|---|
prompterforderlich | string | Beschreiben Sie Motiv, Handlung, Kamerabewegung, Beleuchtung und Stil. | Kein |
reference_image_urls | string[] (URLs) | Bis zu 9 Bilder für Figuren, Produkte, Stil oder Szene. Verweisen Sie mit @Image1, @Image2 usw. darauf. Die ersten 5 sind inbegriffen; jedes weitere Bild kostet eine kleine Gebühr. Maximale Anzahl: 9 | Kein |
reference_video_urls | string[] (video URLs) | Bis zu 3 MP4/MOV-Clips für Bewegung, Kamerafahrten oder Effekte (2–15 Sek. je, 15 s insgesamt, ≤ 50 MB je Datei). Verweisen Sie mit @Video1, @Video2 usw. darauf. Sekunden von Referenzvideos werden wie Ausgabesekunden abgerechnet. Maximale Anzahl: 3 | Ja |
reference_audio_urls | string[] (audio URLs) | Bis zu 3 MP3/WAV-Clips für Stimme, Musik oder Ton (2–15 Sek. je, 15 s insgesamt, ≤ 15 MB je Datei). Verweisen Sie im Prompt mit @Audio1, @Audio2 usw. darauf. Es wird mindestens ein Referenzbild oder -video benötigt. Maximale Anzahl: 3 | Kein |
aspect_ratio | string (enum) | Format des Ausgabebilds. Werte: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 Standard: 16:9 | Ja |
resolution | string (enum) | Ausgabeauflösung. Höhere Auflösungen kosten pro Sekunde mehr. Werte: 480P · 768P Standard: 768P | Ja |
duration | integer | Länge des generierten Clips in Sekunden (4–15 s). Abrechnung pro Sekunde. Bereich: 4–15s Standard: 6 | Ja |
seed | integer | Verwenden Sie denselben Seed und dieselben Einstellungen, um ein Ergebnis zu reproduzieren. Leer lassen für Zufallswerte. | Kein |
enable_safety_checker | boolean | If set to true, the safety checker will be enabled. Content our Acceptable Use Policy prohibits stays blocked either way. Standard: true | Kein |
webhook_url | Zeichenfolge (URL) | Optional. Wir senden die abgeschlossene Generierung per POST an diese URL und signieren die Anfrage mit Ihrem Webhook-Schlüssel. Webhooks | Kein |
Anfrage
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": "Die Sängerin aus @Image1 tritt auf dem Dach auf, folgt der Kamerabewegung aus @Video1 und singt mit der Stimme aus @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);Antwort
{
"id": "gen_8c2QmX1nq0k4",
"object": "generation",
"model": "minimax/h3-fast",
"endpoint": "minimax/h3-fast/reference-to-video",
"mode": "reference-to-video",
"status": "queued",
"input": {
"prompt": "Die Sängerin aus @Image1 tritt auf dem Dach auf, folgt der Kamerabewegung aus @Video1 und singt mit der Stimme aus @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"
}Ergebnis abrufen
Generierungen laufen asynchron. Fragen Sie den Status ab, bis status den Status succeeded, failed oder canceled erreicht – oder übergeben Sie webhook_url bereits beim Absenden. Fehlgeschlagene Generierungen werden automatisch erstattet.
curl https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4 \
-H "Authorization: Bearer $CHEAPERGEN_API_KEY"Mehr: Ablauf eines Auftrags · Webhooks · Fehler
Preise für MiniMax H3 Fast
Zahlen Sie pro Videosekunde nutzungsbasiert, ohne Abo. Fehlgeschlagene Generierungen werden automatisch erstattet.
| Tarifstufe | Offizielle MiniMax-H3-API | CheaperGen | Sie sparen |
|---|---|---|---|
480P pro Sekunde · Audio inklusive · im Vergleich zu MiniMax H3 Max 480P | $0,0369/s Mit einem Monatstarif: Pro $0,0352Max $0,0335 | −26% | |
768P pro Sekunde · Audio inklusive · im Vergleich zu MiniMax H3 768P | $0,0546/s Mit einem Monatstarif: Pro $0,0518Max $0,049 | −32% |
Monatstarife niedrigere Preise für die meisten Modelle (unter jedem Preis angezeigt); Sie können weiterhin nach Verbrauch zahlen. Pro $499/Monat · Max $4.999/Monat.
- Offizielle MiniMax-H3-API: Offizieller Preis der MiniMax-H3-API bei derselben Auflösung, platform.minimax.io (MiniMax verkauft kein H3 Fast, daher dient dies als Referenz: MiniMax H3 in 768P $0.08 / s; in 480P MiniMax H3 Max 480P für $0.05 / s, die einzige offizielle 480P-H3-Tarifstufe von MiniMax). Preise geprüft am 18. Oktober 2026.
- Bei Referenz-zu-Video werden Referenzvideosekunden wie Ausgabesekunden abgerechnet. Die ersten 5 Referenzbilder sind inbegriffen; jedes weitere Bild kostet etwa so viel wie eine Sekunde. Start- und Endbilder sowie Referenz-Audio sind kostenlos.
- Beschleunigte Version: Der durchgestrichene Preis ist der offizielle Preis der MiniMax-H3-API in derselben Auflösung (H3 in 768P, H3 Max in 480P). MiniMax hat keinen Preis für H3 Fast.