Minimax H3 Image-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-image-to-video",
  "prompt": "Den Fokus von der Ramenschüssel im Vordergrund langsam auf die Personen im Hintergrund verlagern. Mehr Dampf steigt natürlich aus der Schüssel auf, während die Kamera sanft vorfährt; Personen und Restaurantumgebung bleiben konsistent.",
  "image_start": "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"
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "minimax-h3-image-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-image-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-image-to-video",
  "prompt": "Den Fokus von der Ramenschüssel im Vordergrund langsam auf die Personen im Hintergrund verlagern. Mehr Dampf steigt natürlich aus der Schüssel auf, während die Kamera sanft vorfährt; Personen und Restaurantumgebung bleiben konsistent.",
  "image_start": "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"
}
'

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

erforderlich

Name des Videogenerierungsmodells

Verfügbare Optionen:

minimax-h3-image-to-video

Beispiel:

"minimax-h3-image-to-video"

prompt

string

erforderlich

Beschreibt die Bewegung im Eingabebild, die Kameraführung und den gewünschten Videoinhalt.

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

Eingabebeschränkungen:

Schlüsselbilder werden über image_start und/oder image_end übergeben
image_urls, video_urls und audio_urls werden nicht unterstützt; ihre Angabe führt zu einem Parameterfehler

Required string length: 1 - 7000

Beispiel:

"Den Fokus von der Ramenschüssel im Vordergrund langsam auf die Personen im Hintergrund verlagern. Mehr Dampf steigt natürlich aus der Schüssel auf, während die Kamera sanft vorfährt; Personen und Restaurantumgebung bleiben konsistent."

image_start

string<uri>

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>

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"

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"

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-image-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 Image-to-Video

Autorisierungen

Body

Antwort