Minimax H3 Reference-to-Video

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "minimax-h3-reference-to-video",
  "prompt": "Die Person aus Image 1 als einzige Charakterreferenz verwenden und Gesicht, Frisur und Kleidung beibehalten. Die Figur läuft im Gegenlicht der Abendsonne über einen Holzsteg am Meer; die Kamera folgt ruhig von einer Halbtotalen bis zu einer seitlichen Nahaufnahme.",
  "image_urls": [
    "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png"
  ],
  "duration": 4,
  "quality": "768p",
  "aspect_ratio": "adaptive"
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "minimax-h3-reference-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 model: minimax-h3-reference-to-video",
    "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"
  }
}

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-reference-to-video",
  "prompt": "Die Person aus Image 1 als einzige Charakterreferenz verwenden und Gesicht, Frisur und Kleidung beibehalten. Die Figur läuft im Gegenlicht der Abendsonne über einen Holzsteg am Meer; die Kamera folgt ruhig von einer Halbtotalen bis zu einer seitlichen Nahaufnahme.",
  "image_urls": [
    "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png"
  ],
  "duration": 4,
  "quality": "768p",
  "aspect_ratio": "adaptive"
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "minimax-h3-reference-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 model: minimax-h3-reference-to-video",
    "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>

Standard:minimax-h3-reference-to-video

erforderlich

Name des Videogenerierungsmodells

Verfügbare Optionen:

minimax-h3-reference-to-video

Beispiel:

"minimax-h3-reference-to-video"

prompt

string

erforderlich

Beschreibt, wie die Referenzmedien verwendet werden sollen und welches Video erzeugt werden soll.

Anforderungen an den Prompt:

Erforderlich und darf nicht leer sein
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

Referenzierung von Medien:

Verwendet Image 1, Image 2, Video 1, Audio 1 usw.; Seedance-Bezeichnungen wie @image1 oder @video1 sind nicht zulässig
Die Nummerierung beginnt bei 1 und folgt der Reihenfolge im jeweiligen URL-Array
Der erste Eintrag in image_urls ist Image 1, der erste in video_urls ist Video 1 und der erste in audio_urls ist Audio 1

Eingabebeschränkungen:

image_start und image_end werden nicht unterstützt
Mindestens 1 Referenzelement ist erforderlich: Bild, Video oder Audio; Referenzaudio kann auch allein verwendet werden

Required string length: 1 - 7000

Beispiel:

"Die Person in Video 1 durch die Figur aus Image 1 ersetzen und Gesicht, Frisur und Kleidung beibehalten. Bewegung, Rhythmus, Bildaufbau und Kamerasprache von Video 1 erhalten und den Dialog mit der Stimme aus Audio 1 lippensynchron wiedergeben."

image_urls

string<uri>[]

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 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>[]

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 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>[]

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 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

Standard:4

Dauer des Ausgabevideos in Sekunden. Standardwert: 4 Sekunden.

Wertebereich:

Nur Ganzzahlen von 4 bis einschließlich 15
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:

4

quality

enum<string>

Standard:768p

Auflösung des Ausgabevideos. Standardwert: 768p.

Verfügbare Werte:

768p: Standardwert
2k

Hinweise:

Ohne diesen Parameter wird in 768p ausgegeben; für 2K muss quality="2k" explizit gesendet werden
Bitrate, Bildrate sowie Video- und Audiocodec werden von der Plattform festgelegt und sind nicht konfigurierbar

Verfügbare Optionen:

768p,

2k

Beispiel:

"768p"

aspect_ratio

enum<string>

Standard:adaptive

Seitenverhältnis des Ausgabevideos. Standardwert: adaptive.

Verfügbare Werte:

adaptive: Das Modell wählt anhand der Referenzmedien und des Prompts ein geeignetes Seitenverhältnis
16:9: Querformat
21:9: Ultra-Breitbild
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:

"adaptive"

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

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-reference-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 Reference-to-Video

Autorisierungen

Body

Antwort