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, Start-/Endbild-Steuerung und multimodale Referenzgenerierung
- Unterstützt 480P / 768P / 1080P und 5–15 Sekunden lange Videos mit Ton
- Unterstützt Referenzbilder, -videos und -audio; kein 2K und keine Zwischenbilder
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:
MiniMax-H3-Max eignet sich für schnelle Text-zu-Video-, Start-/Endbild- und multimodale Referenzgenerierung mit 480P, 768P oder 1080P. Für 2K oder Zwischenbilder 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 | 480P / 768P / 1080P, 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 | Bild, Video und Audio |
| Kosten für Eingabebilder | Erste 5 Bilder kostenlos | Erste 2 Bilder kostenlos; weitere Bilder werden einzeln berechnet |
| Kosten für Referenzvideos | Nach Eingabedauer zum Preis des Ausgabevideos gleicher Auflösung | Nach Eingabedauer zu einem separaten Preis |
| AIGC-Wasserzeichen | Unterstützt | Bei 480P / 768P unterstützt; bei 1080P nicht unterstützt |
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 |
| Multimodale Referenzen (R2V) | image_urls / video_urls / audio_urls oder reference_image in image_with_roles | Generierung aus Referenzbildern, -videos und -audio; auch bei 1080P |
Start-/Endbild-Felder dürfen nicht mit Referenzmedien kombiniert werden. Referenzaudio benötigt mindestens ein Referenzbild oder -video. Ungültige Kombinationen liefern synchron HTTP 400; keine Aufgabe wird 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:
480P, 768P (Standard) oder 1080P.Bei 1080P müssen watermark und der Alias aigc_watermark entfallen, auch wenn der Wert false ist.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
- Multimodale Referenzen: optional, Standard
adaptive; ein konkretes Seitenverhältnis ist ebenfalls möglich
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
Höchstens ein Startbild und ein Endbild. Referenzbilder aus diesem Array und
first_frame_image, last_frame_image oder image_urls.Anzeigen image_with_roles-Element
Anzeigen image_with_roles-Element
image_urls zusammen: maximal 9. Bildrollen für Start/Ende dürfen nicht mit Referenzbildrollen gemischt werden.string[]
Array öffentlicher Referenzbild-URLs. Zusammen mit Referenzbildern in
image_with_roles maximal 9 Bilder. Alle Bilder gelten als Referenzen, nie automatisch als Start-/Endbilder. Dafür first_frame_image oder die Rolle first_frame verwenden.string[]
Array öffentlicher Referenzvideo-URLs; für ein Video auch
video_url (string). Maximal 3 Clips, jeweils 2–15 Sekunden, Referenzvideos insgesamt höchstens 15 Sekunden.Die Referenzvideodauer wird bei Übermittlung zur Abrechnung ermittelt. Ist dies nicht möglich, wird synchron HTTP 400 zurückgegeben; keine Aufgabe wird erstellt oder berechnet.string[]
Array öffentlicher Referenzaudio-URLs; für einen Clip auch
audio_url (string). Maximal 3 Clips, jeweils 2–15 Sekunden, Referenzaudio insgesamt höchstens 15 Sekunden. Mindestens ein Referenzbild oder -video ist erforderlich; Audio allein ist nicht zulässig.boolean
Standard:"false"
AIGC-Wasserzeichen hinzufügen. Alias:
aigc_watermark.Wasserzeichen sind nur bei 480P / 768P unterstützt. Bei 1080P müssen watermark und der Alias aigc_watermark entfallen, auch wenn der Wert false ist.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.Parameterbeschränkungen
Diese ungültigen Parameter oder Kombinationen geben vor Aufgabenerstellung und Abrechnung HTTP 400 zurück:| Parameter / Wert | Grund |
|---|---|
| Start-/Endbilder mit Referenzmedien kombiniert | I2V und R2V schließen sich aus |
Mehr als 9 Referenzbilder oder mehr als 3 Referenzvideos bzw. Audioclips | Medienanzahl überschritten |
| Nur Referenzaudio | Referenzbild oder -video erforderlich |
resolution: "2K" | Nur 480P, 768P und 1080P unterstützt |
duration: 4 oder über 15 | Nur 5–15 Sekunden |
Bei
1080P müssen watermark und der Alias aigc_watermark entfallen, auch wenn der Wert false ist.Für 2K, Zwischenbilder oder ein 4-Sekunden-Video verwenden Sie MiniMax-H3 und passen die Parameter an.
Grenzen für Eingabemedien
Der gesamte Anfragekörper darf höchstens 64 MB groß sein. Für Bilder, Videos und Audio öffentliche URLs verwenden, kein Base64.Bilder
| 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 | Maximal 1 Startbild, 1 Endbild und 9 Referenzbilder; Start-/Endbilder und Referenzbilder nicht mischen |
Referenzvideos
| Element | Grenze |
|---|---|
| Formate | MP4 / MOV, H.264 / H.265 |
| Pro Datei | ≤ 50 MB |
| Anzahl | ≤ 3 |
| Dauer pro Clip | 2–15 s |
| Gesamtdauer | ≤ 15 s |
| Breite und Höhe | 256–5760 px |
| Seitenverhältnis | 0.4–2.5 |
| Bildrate | 23.976–60 fps |
Referenzaudio
| Element | Grenze |
|---|---|
| Formate | WAV / MP3 |
| Pro Datei | ≤ 15 MB |
| Anzahl | ≤ 3 |
| Dauer pro Clip | 2–15 s |
| Gesamtdauer | ≤ 15 s |
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"
}
1080P Text-zu-Video
Bei1080P müssen watermark und der Alias aigc_watermark entfallen, auch wenn der Wert false ist.
{
"model": "MiniMax-H3-Max",
"prompt": "Sonnenuntergang an der Küste, sanfte Wellen am Strand, langsame Kamerafahrt nach vorn, filmische Bildwirkung.",
"duration": 5,
"resolution": "1080P",
"aspect_ratio": "16:9"
}
Multimodale Referenzgenerierung
Jeder Referenzvideo- und Audioclip muss 2–15 Sekunden lang sein. Video- und Audiosummen werden getrennt berechnet und dürfen jeweils höchstens 15 Sekunden betragen. Zu lange Medien sind ungültig und müssen vorher gekürzt werden.{
"model": "MiniMax-H3-Max",
"prompt": "Die Figur aus dem Referenzbild läuft durch die Szene des Referenzvideos im Rhythmus des Referenzaudios.",
"image_urls": [
"https://cdn.example.com/role.png"
],
"video_urls": [
"https://cdn.example.com/scene.mp4"
],
"audio_urls": [
"https://cdn.example.com/beat.mp3"
],
"duration": 6,
"resolution": "1080P",
"aspect_ratio": "16:9"
}
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
Die Gesamtkosten umfassen generiertes Video, zusätzliche Eingabebilder und Referenzvideo:Gesamtkosten = Generierungspreis pro Sekunde × Ausgabedauer
+ Preis pro zusätzlichem Bild × max(0, Eingabebildanzahl − 2)
+ Referenzvideopreis pro Sekunde × gesamte Referenzvideodauer
| Element | Preis |
|---|---|
| 1080P-Video | Gemäß Modellpreisen |
| 768P-Video | Gemäß Modellpreisen |
| 480P-Video | Gemäß Modellpreisen |
| Eingabebilder | Erste 2 Bilder kostenlos; weitere Bilder werden einzeln berechnet; Gemäß Modellpreisen |
| Referenzvideos | Nach Eingabesekunden gemäß Modellpreisen; abhängig von der Ausgabeauflösung und getrennt vom Generierungspreis |
| Referenzaudio | Kostenlos |
| Beispiel | Kosten |
|---|---|
| 768P / 5s | 768P Generierungspreis × 5 |
| 768P / 10s | 768P Generierungspreis × 10 |
| 480P / 10s | 480P Generierungspreis × 10 |
| 480P / 15s | 480P Generierungspreis × 15 |
| 768P / 5s + Bilder × 3 | 768P Generierungspreis × 5 + Preis pro zusätzlichem Bild × 1 |
| 480P / 10s + Referenzvideos (12s) | 480P Generierungspreis × 10 + 480P Referenzvideopreis × 12 |
| 1080P / 5s + Bilder × 2 + Referenzaudio | 1080P Generierungspreis × 5 |
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 |
| Start-/Endbilder mit Referenzmedien kombiniert / Nur Referenzaudio | 400; keine Aufgabe |
Mehr als 9 Referenzbilder oder mehr als 3 Referenzvideos bzw. Audioclips | 400; keine Aufgabe |
| Referenzvideodauer kann nicht ermittelt werden | 400; keine Aufgabe |
| Ungültige Bildrolle oder mehr als ein Bild für dieselbe Start-/Endbildrolle | 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