MiniMaxTutorial
MiniMaxSo verwenden Sie die MiniMax H3 Fast-API
Eine Schritt-für-Schritt-Anleitung zur MiniMax H3 Fast-API mit Node.js, Python und cURL: einen text zu video-Auftrag absenden, den Status abfragen oder einen Webhook empfangen und anschließend die video herunterladen. Das folgende Beispiel kostet $0,23.
- Endpunkte
- 3
- Text zu Video · Bild zu Video · Referenz zu Video
- Beispielanfrage
- $0,23
- Text zu Video
- Sprachen
- 3
- Node.js · Python · cURL
- Fehlgeschlagene Aufträge
- $0
- automatisch erstattet
API-Schlüssel abrufen
Erstellen Sie ein Konto, laden Sie Guthaben auf und erstellen Sie im Dashboard unter „API-Schlüssel“ einen Schlüssel. Speichern Sie ihn als CHEAPERGEN_API_KEY auf Ihrem Server. Jede Anfrage sendet ihn als Bearer-Token.
Wählen Sie einen MiniMax H3 Fast-Endpunkt
Jede Aufgabe hat einen eigenen Endpunkt. Alle erwarten einen JSON-Body und geben eine Generierung zurück, deren Status Sie abfragen können.
| Aufgabe | Endpunkt | Erforderlich | Ab |
|---|---|---|---|
| Text zu Video | minimax/h3-fast/text-to-video | prompt | $0,0237 pro Sekunde |
| Bild zu Video | minimax/h3-fast/image-to-video | prompt, image_url | $0,0237 pro Sekunde |
| Referenz zu Video | minimax/h3-fast/reference-to-video | prompt | $0,0237 pro Sekunde |
Einen text zu video-Auftrag absenden
Dieses Programm übermittelt den Auftrag, fragt alle 3 Sekunden bis zum Abschluss den Status ab und gibt die video-URL aus. Ersetzen Sie Prompt und Einstellungen durch Ihre eigenen.
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);Wichtige Parameter festlegen
Die Einstellungen für minimax/h3-fast/text-to-video und ihre Auswirkungen auf den Preis.
| Parameter | Typ · Standardwert | Beschreibung | Preisauswirkung |
|---|---|---|---|
| aspect_ratio | string (enum) · 16:9 | Format des Ausgabebilds. 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 | Ja |
| resolution | string (enum) · 768P | Ausgabeauflösung. Höhere Auflösungen kosten pro Sekunde mehr. 480P · 768P | 480P: $0,0237 pro Sekunde 768P: $0,038 pro Sekunde |
| duration | integer · 6 | Länge des generierten Clips in Sekunden (4–15 s). Abrechnung pro Sekunde. | Abrechnung pro Sekunde |
| seed | integer | Verwenden Sie denselben Seed und dieselben Einstellungen, um ein Ergebnis zu reproduzieren. Leer lassen für Zufallswerte. | Keine |
| enable_safety_checker | boolean · true | If set to true, the safety checker will be enabled. Content our Acceptable Use Policy prohibits stays blocked either way. | Keine |
Weitere MiniMax H3 Fast-Endpunkte verwenden dieselbe Struktur, aber jeweils eigene Eingabefelder:
POST /api/v1/run/minimax/h3-fast/image-to-video
{
"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
}POST /api/v1/run/minimax/h3-fast/reference-to-video
{
"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
}Ergebnis abrufen
Ein Auftrag wechselt von queued zu running und anschließend zu succeeded, failed oder canceled. Fragen Sie GET /api/v1/generations/{id} ab oder übergeben Sie webhook_url; dann senden wir Ihnen das Ergebnis per POST. Laden Sie die Ausgabe herunter und speichern Sie sie selbst.
200 — succeeded
{
"id": "gen_8c2QmX1nq0k4",
"object": "generation",
"model": "minimax/h3-fast",
"endpoint": "minimax/h3-fast/text-to-video",
"mode": "text-to-video",
"status": "succeeded",
"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": {
"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"
}Preis vor der Ausführung abfragen
Der Angebotsendpunkt ist kostenlos und erfordert keinen Schlüssel. Er gibt den Preis, Preis von official MiniMax H3 API und Ihren Rabatt genau für die übermittelten Eingaben zurück.
curl -X POST https://cheapergen.com/api/v1/quote/minimax/h3-fast/text-to-video \
-H "Content-Type: application/json" \
-d '{"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}'| Status | Code | Bedeutung |
|---|---|---|
| 400 | invalid_request | Ein Parameter fehlt oder liegt außerhalb des zulässigen Bereichs – die Meldung nennt ihn. |
| 401 | unauthorized | API-Schlüssel fehlt, ist fehlerhaft formatiert oder wurde widerrufen. |
| 402 | insufficient_balance | Ihr Guthaben reicht nicht für den angebotenen Preis. Laden Sie es auf oder aktivieren Sie die automatische Aufladung. |
| 429 | rate_limited | Zu viele Anfragen oder gleichzeitig laufende Generierungen. Warten Sie kurz und versuchen Sie es erneut. |
| 502 | upstream_error | Die Verarbeitung durch das Modell ist fehlgeschlagen. Der reservierte Betrag wird erstattet; Sie können es erneut versuchen. |
| 503 | model_unavailable | Derzeit ist kein geeigneter Verarbeitungsweg verfügbar. Versuchen Sie es später erneut oder wählen Sie ein anderes Modell. |
FAQ
MiniMax H3 Fast-API: häufige Fragen
Nein. Die API verwendet einfaches HTTPS mit JSON. Die Beispiele für Node.js (fetch) und Python (requests) auf dieser Seite sind vollständige Programme. Jede Sprache, die HTTP-Anfragen senden kann, funktioniert.
Ja. Fügen Sie „webhook_url“ in den Anfrage-Body ein. Wir senden die abgeschlossene Generierung dann signiert an diese Adresse, mit dem Header CheaperGen-Signature (HMAC-SHA256 aus Zeitstempel und rohem Body). GET /api/v1/generations/{id} zum Abfragen des Status funktioniert ebenfalls.
Übergeben Sie öffentliche URLs in "image_url", "end_image_url", "reference_image_urls", "reference_video_urls", "reference_audio_urls". Dateien ohne öffentliche URL können Sie zuerst mit POST /api/v1/uploads hochladen. Der Aufruf gibt eine URL zurück, die Sie in der Anfrage verwenden.
Text zu Video kostet ab $0,0237 pro Sekunde; die Beispielanfrage auf dieser Seite kostet $0,23, 52% unter Preis von official MiniMax H3 API. Fehlgeschlagene Generierungen werden automatisch erstattet.