curl --request POST \
--url https://api.apimart.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "MiniMax-H3-Max",
"prompt": "Ein Detektiv im Trenchcoat dreht sich auf einer verregneten, neonbeleuchteten Straße um. Die Kamera fährt langsam näher.",
"duration": 5,
"resolution": "768P",
"aspect_ratio": "16:9"
}'
import requests
response = requests.post(
"https://api.apimart.ai/v1/videos/generations",
headers={"Authorization": "Bearer <token>", "Content-Type": "application/json"},
json={
"model": "MiniMax-H3-Max",
"prompt": "Ein Detektiv dreht sich auf einer verregneten Neonstraße um.",
"duration": 5,
"resolution": "768P",
"aspect_ratio": "16:9",
},
)
print(response.json())
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ"
}
]
}
{
"error": {
"code": 400,
"message": "Ungültige Anfrageparameter",
"type": "invalid_request_error"
}
}
{
"error": {
"code": 401,
"message": "Authentifizierung fehlgeschlagen. Prüfen Sie Ihren API-Schlüssel.",
"type": "authentication_error"
}
}
{
"error": {
"code": 402,
"message": "Unzureichendes Kontoguthaben",
"type": "payment_required"
}
}
MiniMax-H3
MiniMax-H3-Max Videogenerierung
- Schnelle Version von MiniMax Video Generation V2 mit asynchroner Aufgabenübermittlung
- Unterstützt Text-zu-Video und Bild-zu-Video mit Start-, End- oder Start-und-Endbild
- Unterstützt 768P / 480P und 5 bis 15 Sekunden lange Videos mit Ton
- Keine Unterstützung für 2K, Zwischenbilder oder multimodale Referenzgenerierung
POST
/
v1
/
videos
/
generations
curl --request POST \
--url https://api.apimart.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "MiniMax-H3-Max",
"prompt": "Ein Detektiv im Trenchcoat dreht sich auf einer verregneten, neonbeleuchteten Straße um. Die Kamera fährt langsam näher.",
"duration": 5,
"resolution": "768P",
"aspect_ratio": "16:9"
}'
import requests
response = requests.post(
"https://api.apimart.ai/v1/videos/generations",
headers={"Authorization": "Bearer <token>", "Content-Type": "application/json"},
json={
"model": "MiniMax-H3-Max",
"prompt": "Ein Detektiv dreht sich auf einer verregneten Neonstraße um.",
"duration": 5,
"resolution": "768P",
"aspect_ratio": "16:9",
},
)
print(response.json())
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ"
}
]
}
{
"error": {
"code": 400,
"message": "Ungültige Anfrageparameter",
"type": "invalid_request_error"
}
}
{
"error": {
"code": 401,
"message": "Authentifizierung fehlgeschlagen. Prüfen Sie Ihren API-Schlüssel.",
"type": "authentication_error"
}
}
{
"error": {
"code": 402,
"message": "Unzureichendes Kontoguthaben",
"type": "payment_required"
}
}
Modellwahl: Verwenden Sie
MiniMax-H3-Max, wenn Geschwindigkeit im Vordergrund steht und Text-zu-Video oder Start-/Endbild-Steuerung genügt. Für 2K, Zwischenbilder, Referenzbilder, -videos oder -audio verwenden Sie MiniMax-H3.curl --request POST \
--url https://api.apimart.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "MiniMax-H3-Max",
"prompt": "Ein Detektiv im Trenchcoat dreht sich auf einer verregneten, neonbeleuchteten Straße um. Die Kamera fährt langsam näher.",
"duration": 5,
"resolution": "768P",
"aspect_ratio": "16:9"
}'
import requests
response = requests.post(
"https://api.apimart.ai/v1/videos/generations",
headers={"Authorization": "Bearer <token>", "Content-Type": "application/json"},
json={
"model": "MiniMax-H3-Max",
"prompt": "Ein Detektiv dreht sich auf einer verregneten Neonstraße um.",
"duration": 5,
"resolution": "768P",
"aspect_ratio": "16:9",
},
)
print(response.json())
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ"
}
]
}
{
"error": {
"code": 400,
"message": "Ungültige Anfrageparameter",
"type": "invalid_request_error"
}
}
{
"error": {
"code": 401,
"message": "Authentifizierung fehlgeschlagen. Prüfen Sie Ihren API-Schlüssel.",
"type": "authentication_error"
}
}
{
"error": {
"code": 402,
"message": "Unzureichendes Kontoguthaben",
"type": "payment_required"
}
}
Authentifizierung
string
erforderlich
Alle Endpunkte erfordern Bearer-Token-Authentifizierung. Den Schlüssel erhalten Sie auf der API-Key-Seite.
Authorization: Bearer YOUR_API_KEY
Das richtige Modell wählen
| Fähigkeit | MiniMax-H3 | MiniMax-H3-Max |
|---|---|---|
| Auflösung | 2K / 768P, Standard 2K | 768P / 480P, Standard 768P |
| Dauer | 4–15 Sekunden | 5–15 Sekunden |
| Text-zu-Video | Unterstützt | Unterstützt |
| Start-/Endbild | Unterstützt | Unterstützt |
| Zwischenbild | Unterstützt | Nicht unterstützt |
| Multimodale Referenzen | Bild, Video und Audio | Nicht unterstützt |
| Kosten für Eingabebilder | Erste 5 Bilder kostenlos | Kostenlos |
MiniMax-H3-Max unterstützt kein 2K und kann nicht als Quelle für Regeneration dienen.Generierungsmodi
Die Felder der Anfrage bestimmen den Modus automatisch; senden Sie keinmode-Feld.
| Modus | Auslöser | Verhalten |
|---|---|---|
| Text-zu-Video (T2V) | Nur prompt und allgemeine Felder | Generierung aus Text |
| Bild-zu-Video (I2V) | first_frame_image / last_frame_image oder entsprechende Rollen in image_with_roles | Steuerung des Startbilds, Endbilds oder beider |
Dieses Modell unterstützt weder
image_urls, video_urls und audio_urls noch image_with_roles[].role = "reference_image". Referenzmedien führen synchron zu HTTP 400; es wird keine Aufgabe erstellt oder berechnet.Anfrageparameter
string
erforderlich
Fester Wert:
MiniMax-H3-Max. Modell-IDs sind nicht groß-/kleinschreibungssensitiv; minimax-h3-max wird ebenfalls akzeptiert.string
erforderlich
Nicht leere Videobeschreibung, in jedem Modus erforderlich. Maximal
7000 Zeichen.integer
Standard:"5"
Videodauer in Sekunden: Ganzzahl von
5 bis 15, Standard 5. Vier Sekunden werden nicht unterstützt.string
Standard:"768P"
Ausgabeauflösung:
768P (Standard) oder 480P.2K, 1440P und 2048P werden nicht unterstützt. Ungültige Werte geben HTTP 400 zurück und werden nicht automatisch herabgestuft.string
Ausgabe-Seitenverhältnis. Die Aliasfelder
size und ratio werden ebenfalls akzeptiert.Für Text-zu-Video: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16.- T2V ohne Feld oder mit
adaptive: Rückfall auf16:9 - I2V: wird durch das Eingabebild bestimmt; dieses Feld wird ignoriert
string
Öffentliche Bild-URL für das Startbild.
string
Öffentliche Bild-URL für das Endbild. Kann allein oder zusammen mit
first_frame_image verwendet werden.object[]
Rollenbasiertes Bildarray als Alternative zu
Pro Rolle ist höchstens ein Bild zulässig;
first_frame_image und last_frame_image.Anzeigen image_with_roles-Element
Anzeigen image_with_roles-Element
role darf nicht leer sein.boolean
Standard:"false"
AIGC-Wasserzeichen hinzufügen. Alias:
aigc_watermark.string
Empfängt eine Benachrichtigung, wenn die Aufgabe erfolgreich oder fehlgeschlagen beendet wurde.
Verwenden Sie
webhook statt MiniMax’ callback_url. Das Gateway reserviert callback_url für interne Zwecke.Nicht unterstützte Parameter
Diese Werte geben vor Aufgabenerstellung und Abrechnung HTTP 400 zurück:| Parameter / Wert | Grund |
|---|---|
image_urls | Wird als Referenzbild behandelt; Referenzen werden nicht unterstützt |
image_with_roles[].role = "reference_image" | Nur Start- und Endbild sind zulässig |
video_urls / video_url | Kein Referenzvideo |
audio_urls / audio_url | Kein Referenzaudio |
resolution: "2K" | Nur 768P und 480P |
duration: 4 oder über 15 | Nur 5–15 Sekunden |
Für Referenzmedien, 2K, Zwischenbilder oder vier Sekunden verwenden Sie MiniMax-H3.
Bildbeschränkungen
Der gesamte Anfragekörper darf höchstens 64 MB groß sein. Verwenden Sie öffentliche URLs; Base64 wird nicht unterstützt.| Element | Grenze |
|---|---|
| Formate | JPG / JPEG / PNG / WEBP / HEIC / HEIF |
| Pro Datei | ≤ 30 MB |
| Breite und Höhe | 256–5760 px |
| Seitenverhältnis | 0,4–2,5 |
| Anzahl | Höchstens 1 Startbild und 1 Endbild; insgesamt 2 |
Beispiele
Bild-zu-Video mit Startbild
{
"model": "MiniMax-H3-Max",
"prompt": "Die Kamera fährt langsam näher, während Dampf aufsteigt.",
"first_frame_image": "https://cdn.example.com/ramen.png",
"duration": 5,
"resolution": "480P"
}
Bild-zu-Video mit Start- und Endbild
{
"model": "MiniMax-H3-Max",
"prompt": "Die Szene geht langsam vom Morgen in den Sonnenuntergang über.",
"first_frame_image": "https://cdn.example.com/morning.png",
"last_frame_image": "https://cdn.example.com/sunset.png",
"duration": 8,
"resolution": "768P"
}
Aufgabe abfragen
Die Übermittlung gibt einetask_id zurück. Fragen Sie den Aufgabenstatus alle 5–10 Sekunden ab; empfohlenes Client-Timeout: 15 Minuten.
status | Bedeutung |
|---|---|
pending | Übermittelt oder in Warteschlange |
processing | Wird generiert |
completed | Video-URL unter result.videos[0].url |
failed | error.message prüfen; automatische Erstattung |
Generierte Video-URLs laufen in der Regel nach etwa 24 Stunden ab. Laden Sie das Ergebnis rechtzeitig herunter.
Preise
Gesamtkosten = Sekundenpreis × Videodauer. Start- und Endbilder sind kostenlos.| Element | Preis |
|---|---|
| 768P-Video | $0.075 / Sekunde |
| 480P-Video | $0.0495 / Sekunde |
| Eingabebilder | Kostenlos |
cost in der Aufgabenantwort.
Fehler
| Szenario | Ergebnis |
|---|---|
Leerer oder über 7000 Zeichen langer prompt | 400; keine Aufgabe |
duration außerhalb 5–15 | 400; keine Aufgabe |
Nicht unterstützte resolution | 400; keine Aufgabe |
| Referenzmedien | 400; keine Aufgabe |
| Ungültige oder doppelte Bildrolle | 400; keine Aufgabe |
| Unzureichendes Guthaben | 402 |
| Inhaltssicherheits-Ablehnung | 422 |
| Ratenbegrenzung | 429; mit Backoff erneut versuchen |
status = failed und error.message; die Kosten werden automatisch erstattet.
Response
integer
Antwortstatuscode; bei Erfolg 200