curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "minimax-h3-text-to-video",
  "prompt": "Epischer Space-Opera-Trailer: Eine Kapitänin steht allein vor einem riesigen Aussichtsfenster, während sich draußen die letzte Flotte sammelt. Beim Sprung der Flotte bricht grelles weißes Licht hervor und die Brücke bebt heftig; als das Licht erlischt, bleibt sie allein im stillen Weltraum zurück. Filmische Beleuchtung, langsame Kamerafahrt nach vorn, großartige und zugleich zurückhaltende Atmosphäre.",
  "duration": 4,
  "quality": "768p",
  "aspect_ratio": "16:9"
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "minimax-h3-text-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 165,
    "video_duration": 4
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 44.2,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to the specified model",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Minimax H3

Minimax H3 / H3 Max Leitfaden für alle Parameter

Einheitliche API für die gesamte Minimax-H3- und H3-Max-Serie. Der Generierungsmodus wird über den Parameter model gewählt.

3 Generierungsmodi, 5 Modelle:

Modus	Modell-ID	Eingabemedien
Text-to-Video	`minimax-h3-text-to-video`	Nur `prompt`
Text-to-Video	`minimax-h3-max-text-to-video`	Nur `prompt`
Image-to-Video	`minimax-h3-image-to-video`	`prompt` + `image_start` und/oder `image_end`
Image-to-Video	`minimax-h3-max-image-to-video`	`prompt` + `image_start` und/oder `image_end`
Reference-to-Video	`minimax-h3-reference-to-video`	`prompt` + `image_urls` / `video_urls` / `audio_urls`

Parameterunterschiede:

Minimax H3: Ausgabedauer von 4 bis 15 Sekunden; Auflösung 768p (Standard) oder 2k
Minimax H3 Max: Ausgabedauer von 5 bis 15 Sekunden; Auflösung 480p oder 768p (Standard)

Gemeinsame Funktionen:

Asynchrone Verarbeitung; mit der zurückgegebenen Aufgaben-ID kann die Aufgabe abgefragt werden
Minimax-H3- und H3-Max-Aufgaben können nicht abgebrochen werden
Generierte Video-URLs sind 24 Stunden gültig; speichern Sie das Ergebnis zeitnah

POST

videos

generations

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "minimax-h3-text-to-video",
  "prompt": "Epischer Space-Opera-Trailer: Eine Kapitänin steht allein vor einem riesigen Aussichtsfenster, während sich draußen die letzte Flotte sammelt. Beim Sprung der Flotte bricht grelles weißes Licht hervor und die Brücke bebt heftig; als das Licht erlischt, bleibt sie allein im stillen Weltraum zurück. Filmische Beleuchtung, langsame Kamerafahrt nach vorn, großartige und zugleich zurückhaltende Atmosphäre.",
  "duration": 4,
  "quality": "768p",
  "aspect_ratio": "16:9"
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "minimax-h3-text-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 165,
    "video_duration": 4
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 44.2,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to the specified model",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Autorisierungen

Authorization

string

header

erforderlich

##Alle Schnittstellen erfordern eine Authentifizierung mit Bearer Token##

API Key erhalten:

Besuchen Sie die API-Key-Verwaltungsseite, um Ihren API Key zu erhalten

Fügen Sie ihn im Anfrage-Header hinzu:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

enum<string>

erforderlich

Name des Videogenerierungsmodells.

Modell-ID	Modus	Medienparameter
`minimax-h3-text-to-video`	Text-zu-Video	Akzeptiert keine Medien
`minimax-h3-max-text-to-video`	Text-zu-Video	Akzeptiert keine Medien
`minimax-h3-image-to-video`	Bild-zu-Video	`image_start` und/oder `image_end`
`minimax-h3-max-image-to-video`	Bild-zu-Video	`image_start` und/oder `image_end`
`minimax-h3-reference-to-video`	Multimodale Referenz-zu-Video	`image_urls` / `video_urls` / `audio_urls`

Verfügbare Optionen:

minimax-h3-text-to-video,

minimax-h3-max-text-to-video,

minimax-h3-image-to-video,

minimax-h3-max-image-to-video,

minimax-h3-reference-to-video

Beispiel:

"minimax-h3-text-to-video"

prompt

string

erforderlich

Beschreibt das gewünschte Video. Dieses Feld ist erforderlich und darf nicht leer sein.

Anforderungen an den Prompt:

Chinesisch und Englisch werden unterstützt
Maximal 7000 Zeichen (Chinesisch und Englisch werden jeweils nach Zeichen gezählt)
Bei zu langen Prompts kann das Modell Details ignorieren

Verwendung je Modell:

Text-to-Video: Szene, Motiv, Handlung, Kamera und Stimmung beschreiben; keine Medienfelder angeben
Image-to-Video: Beschreiben, wie sich Motive im ersten/letzten Bild bewegen und wie sich die Kamera verändert; image_start und/oder image_end verwenden
Reference-to-Video: Die Verwendung der Referenzmedien beschreiben. Medien als Image 1, Image 2, Video 1, Audio 1 usw. referenzieren; keine Seedance-Schreibweise wie @image1 oder @video1 verwenden. Die Nummerierung beginnt bei 1 und entspricht der Reihenfolge im jeweiligen URL-Array

Required string length: 1 - 7000

Beispiel:

"Filmische Szene: Ein Astronaut steht vor dem Aussichtsfenster einer Mondbasis, während die Kamera langsam näher fährt und die Erde am fernen Horizont aufgeht."

image_start

string<uri>

Unterstützte Modelle:

minimax-h3-image-to-video
minimax-h3-max-image-to-video
Text-zu-Video und Referenz-zu-Video unterstützen diesen Parameter nicht

HTTP(S)-URL des ersten Schlüsselbilds.

Kombinationsregeln:

Mindestens eines der Felder image_start und image_end muss angegeben werden
Nur image_start: Bild-zu-Video ab dem ersten Frame
Beide Felder: Bild-zu-Video mit erstem und letztem Frame
Höchstens 1 erster Frame; dieses Feld akzeptiert eine URL

Bildanforderungen:

Formate: JPG, JPEG, PNG, WEBP, HEIC, HEIF
Dateigröße: höchstens 30MB
Breite und Höhe: jeweils 256 bis 5760 px
Seitenverhältnis (Breite/Höhe): 0.4–2.5
Die URL muss HTTP(S) verwenden und für den Dienst direkt erreichbar sein
Der gesamte JSON-Anfragetext darf 64MB nicht überschreiten; Base64- und mm_file://-Eingaben werden nicht akzeptiert

Beispiel:

"https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png"

image_end

string<uri>

Unterstützte Modelle:

minimax-h3-image-to-video
minimax-h3-max-image-to-video
Text-zu-Video und Referenz-zu-Video unterstützen diesen Parameter nicht

HTTP(S)-URL des letzten Schlüsselbilds.

Kombinationsregeln:

Mindestens eines der Felder image_end und image_start muss angegeben werden
Nur image_end: Das Modell erzeugt eine natürliche Bewegung, die mit diesem Frame endet
Beide Felder: Bild-zu-Video mit erstem und letztem Frame
Höchstens 1 letzter Frame; dieses Feld akzeptiert eine URL

Bildanforderungen:

Formate: JPG, JPEG, PNG, WEBP, HEIC, HEIF
Dateigröße: höchstens 30MB
Breite und Höhe: jeweils 256 bis 5760 px
Seitenverhältnis (Breite/Höhe): 0.4–2.5
Die URL muss HTTP(S) verwenden und für den Dienst direkt erreichbar sein
Der gesamte JSON-Anfragetext darf 64MB nicht überschreiten; Base64- und mm_file://-Eingaben werden nicht akzeptiert

Beispiel:

"https://images.unsplash.com/photo-1515003197210-e0cd71810b5f?auto=format&fit=crop&w=1920&q=85"

image_urls

string<uri>[]

Unterstützte Modelle:

Nur minimax-h3-reference-to-video
Text-zu-Video und Bild-zu-Video unterstützen diesen Parameter nicht

Array mit HTTP(S)-URLs für Referenzbilder. Standardwert []; höchstens 9 Bilder.

Rolle und Nummerierung:

Alle Bilder werden als reference_image verwendet
Der erste Eintrag ist Image 1, der zweite Image 2 usw.

Bildanforderungen:

Formate: JPG, JPEG, PNG, WEBP, HEIC, HEIF
Dateigröße: höchstens 30MB pro Bild
Breite und Höhe: jeweils 256 bis 5760 px
Seitenverhältnis (Breite/Höhe): 0.4–2.5
URLs müssen HTTP(S) verwenden und für den Dienst direkt erreichbar sein
Der gesamte JSON-Anfragetext darf 64MB nicht überschreiten; Base64- und mm_file://-Eingaben werden nicht akzeptiert

Kombinationsregeln:

Mindestens eines von image_urls, video_urls oder audio_urls ist erforderlich
Insgesamt sind höchstens 12 Referenzelemente zulässig (Referenzbilder + Referenzvideos + Referenzaudios)
Sind alle drei leer, wird ein Parameterfehler zurückgegeben; für reine Textgenerierung minimax-h3-text-to-video oder minimax-h3-max-text-to-video verwenden

Maximum array length: 9

Beispiel:

[
  "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png"
]

video_urls

string<uri>[]

Unterstützte Modelle:

Nur minimax-h3-reference-to-video
Text-zu-Video und Bild-zu-Video unterstützen diesen Parameter nicht

Array mit HTTP(S)-URLs für Referenzvideos. Standardwert []; höchstens 3 Videos.

Rolle und Nummerierung:

Alle Videos werden als reference_video verwendet
Der erste Eintrag ist Video 1, der zweite Video 2 usw.

Videoanforderungen:

Container: MP4 (.mp4), MOV (.mov)
Videocodecs: H.264/AVC, H.265/HEVC
Eingebettete Audiocodecs: AAC, MP3
Dateigröße: höchstens 50MB pro Video
Dauer: 2–15 Sekunden pro Clip; Gesamtdauer aller Referenzvideos höchstens 15 Sekunden
Breite und Höhe: jeweils 256 bis 5760 px
Seitenverhältnis (Breite/Höhe): 0.4–2.5
Bildrate: 23.976–60 FPS
URLs müssen HTTP(S) verwenden und für den Dienst direkt erreichbar sein
Der gesamte JSON-Anfragetext darf 64MB nicht überschreiten; Base64- und mm_file://-Eingaben werden nicht akzeptiert

Abrechnung:

Die Eingabedauer der Referenzvideos wird berechnet

Kombinationsregeln:

Mindestens eines von image_urls, video_urls oder audio_urls ist erforderlich
Insgesamt sind höchstens 12 Referenzelemente zulässig (Referenzbilder + Referenzvideos + Referenzaudios)
Sind alle drei leer, wird ein Parameterfehler zurückgegeben; für reine Textgenerierung minimax-h3-text-to-video oder minimax-h3-max-text-to-video verwenden

Maximum array length: 3

Beispiel:

[
  "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/h3_promo_eval_ref2va/gallery/sr_v2p26_trio_seed42_20260724/inputs/297573323635_00_%E8%A7%86%E9%A2%911_YnyRbxEwio_video_20260525_163755_1927e9d3.mp4"
]

audio_urls

string<uri>[]

Unterstützte Modelle:

Nur minimax-h3-reference-to-video
Text-zu-Video und Bild-zu-Video unterstützen diesen Parameter nicht

Array mit HTTP(S)-URLs für Referenzaudio. Standardwert []; höchstens 3 Clips.

Rolle und Nummerierung:

Alle Audioclips werden als reference_audio verwendet
Der erste Eintrag ist Audio 1, der zweite Audio 2 usw.

Audioanforderungen:

Formate: WAV, MP3
Dateigröße: höchstens 15MB pro Clip
Dauer: 2–15 Sekunden pro Clip; Gesamtdauer aller Referenzaudios höchstens 15 Sekunden
URLs müssen HTTP(S) verwenden und für den Dienst direkt erreichbar sein
Der gesamte JSON-Anfragetext darf 64MB nicht überschreiten; Base64- und mm_file://-Eingaben werden nicht akzeptiert

Abrechnung:

Die Dauer von Referenzaudio wird nicht berechnet

Kombinationsregeln:

audio_urls kann allein verwendet werden; ein Referenzbild oder -video ist nicht erforderlich
Insgesamt sind höchstens 12 Referenzelemente zulässig (Referenzbilder + Referenzvideos + Referenzaudios)
Sind alle drei leer, wird ein Parameterfehler zurückgegeben; für reine Textgenerierung minimax-h3-text-to-video oder minimax-h3-max-text-to-video verwenden

Maximum array length: 3

Beispiel:

[
  "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/h3_promo_eval_ref2va/gallery/sr_v2p26_trio_seed42_20260724/inputs/f463d523c5ce_01_%E9%9F%B3%E9%A2%911_RSLcbpzJPo_6%E6%9C%885%E6%97%A5(1).mp3"
]

duration

integer

Dauer des Ausgabevideos in Sekunden. Wertebereich und Standardwert hängen von model ab.

Unterstützte Modelle:

Alle 5 Minimax-H3- und H3-Max-Modelle

Modellbeschränkungen:

Minimax H3: Ganzzahlen von 4 bis einschließlich 15; Standardwert 4 Sekunden
Minimax H3 Max: Ganzzahlen von 5 bis einschließlich 15; Standardwert 5 Sekunden
Dezimalzahlen, numerische Zeichenketten, auto und -1 werden nicht unterstützt
Die Ausgabedauer wirkt sich direkt auf die Abrechnung aus

Erforderlicher Bereich: 4 <= x <= 15

Beispiel:

5

quality

enum<string>

Standard:768p

Auflösung des Ausgabevideos. Standardwert: 768p.

Unterstützte Modelle:

Alle 5 Minimax-H3- und H3-Max-Modelle

Verfügbare Werte nach Modell:

Minimax H3: 768p (Standard), 2k
Minimax H3 Max: 480p, 768p (Standard)

Hinweise:

Ohne diesen Parameter wird in 768p ausgegeben
Bitrate, Bildrate sowie Video- und Audiocodec werden von der Plattform festgelegt und sind nicht konfigurierbar

Verfügbare Optionen:

480p,

768p,

2k

Beispiel:

"768p"

aspect_ratio

enum<string>

Seitenverhältnis des Ausgabevideos.

Unterstützte Modelle und Standardwerte:

minimax-h3-text-to-video, minimax-h3-max-text-to-video: nur explizite Seitenverhältnisse; Standardwert 16:9
minimax-h3-reference-to-video: unterstützt alle unten aufgeführten Optionen; Standardwert adaptive
minimax-h3-image-to-video, minimax-h3-max-image-to-video: Das Modell passt das Seitenverhältnis des Ausgabevideos automatisch an das Eingabebild an; diesen Parameter bei Bild-zu-Video-Anfragen nicht senden

Verfügbare Werte:

adaptive: nur für Referenz-zu-Video; das Modell wählt anhand der Referenzmedien und des Prompts ein geeignetes Seitenverhältnis
16:9: Querformat
21:9: Ultraweit
4:3: Standard-Querformat
1:1: Quadrat
3:4: Standard-Hochformat
9:16: Hochformat

Verfügbare Optionen:

adaptive,

16:9,

21:9,

4:3,

1:1,

3:4,

9:16

Beispiel:

"16:9"

callback_url

string<uri>

HTTPS-Callback-URL nach Aufgabenabschluss

Callback-Zeitpunkte:

Wird bei Aufgabenabschluss (completed) oder Fehler (failed) ausgelöst
Wird nach Bestätigung der Abrechnung gesendet

Sicherheitseinschränkungen:

Nur HTTPS-Protokoll unterstützt
Callbacks an interne IP-Adressen sind verboten (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x usw.)
URL-Länge maximal 2048 Zeichen

Callback-Mechanismus:

Timeout: 10 Sekunden
Maximal 3 Wiederholungsversuche nach Fehler (jeweils nach 1/2/4 Sekunden)
Das Format des Callback-Antwortkörpers entspricht dem Rückgabeformat der Aufgabenabfrage-Schnittstelle
Ein 2xx-Statuscode gilt als Erfolg, andere Statuscodes lösen Wiederholungsversuche aus

Unterstützte Modelle:

Alle 5 Minimax-H3- und H3-Max-Modelle

Pattern: ^https://

Beispiel:

"https://your-domain.com/webhooks/video-task-completed"

Antwort

Videogenerierungsaufgabe erfolgreich erstellt

created

integer

Zeitstempel der Aufgabenerstellung

Beispiel:

1761313744

string

Aufgaben-ID

Beispiel:

"task-unified-1774857405-abc123"

model

string

Tatsächlich verwendeter Modellname

Beispiel:

"minimax-h3-text-to-video"

object

enum<string>

Spezifischer Aufgabentyp

Verfügbare Optionen:

video.generation.task

progress

integer

Aufgabenfortschritt in Prozent (0-100)

Erforderlicher Bereich: 0 <= x <= 100

Beispiel:

0

status

enum<string>

Aufgabenstatus

Verfügbare Optionen:

pending,

processing,

completed,

failed

Beispiel:

"pending"

task_info

object

Detaillierte Informationen zur Videoaufgabe

Show child attributes

type

enum<string>

Ausgabetyp der Aufgabe

Verfügbare Optionen:

text,

image,

audio,

video

Beispiel:

"video"

usage

object

Nutzungs- und Abrechnungsinformationen

Show child attributes

Bildserie

Videoserie

Audioserie

Textserie

Kontoverwaltung

Aufgabenverwaltung

Dateiverwaltung

Minimax H3 / H3 Max Leitfaden für alle Parameter

Autorisierungen

Body

Antwort