> ## Documentation Index > Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Minimax H3 Leitfaden für alle Parameter > Einheitliche API für die gesamte Minimax-H3-Serie. Der Generierungsmodus wird über den Parameter `model` gewählt. **3 Generierungsmodi:** | Modus | Modell-ID | Eingabemedien | |:---|:---|:---| | Text-to-Video | `minimax-h3-text-to-video` | Nur `prompt` | | Image-to-Video | `minimax-h3-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` | **Gemeinsame Funktionen:** - Ausgabedauer von `5` bis `15` Sekunden; derzeit wird nur `2k` unterstützt - Asynchrone Verarbeitung; mit der zurückgegebenen Aufgaben-ID kann die [Aufgabe abgefragt](/de/api-manual/task-management/get-task-detail) werden - Minimax-H3-Aufgaben können nicht abgebrochen werden - Generierte Video-URLs sind 24 Stunden gültig; speichern Sie das Ergebnis zeitnah ## OpenAPI ````yaml de/api-manual/video-series/minimax/minimax-h3/minimax-h3-overview.json POST /v1/videos/generations openapi: 3.1.0 info: title: Minimax H3 API für alle Modelle description: >- Einheitliche API für alle 3 Minimax-H3-Modelle: Text-zu-Video, Bild-zu-Video und multimodale Referenz-zu-Video-Generierung license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Produktionsumgebung security: - bearerAuth: [] tags: - name: Videogenerierung description: API-Schnittstellen für KI-Videogenerierung paths: /v1/videos/generations: post: tags: - Videogenerierung summary: Minimax H3 Videogenerierung (alle Modelle) description: >- Einheitliche API für die gesamte Minimax-H3-Serie. Der Generierungsmodus wird über den Parameter `model` gewählt. **3 Generierungsmodi:** | Modus | Modell-ID | Eingabemedien | |:---|:---|:---| | Text-to-Video | `minimax-h3-text-to-video` | Nur `prompt` | | Image-to-Video | `minimax-h3-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` | **Gemeinsame Funktionen:** - Ausgabedauer von `5` bis `15` Sekunden; derzeit wird nur `2k` unterstützt - Asynchrone Verarbeitung; mit der zurückgegebenen Aufgaben-ID kann die [Aufgabe abgefragt](/de/api-manual/task-management/get-task-detail) werden - Minimax-H3-Aufgaben können nicht abgebrochen werden - Generierte Video-URLs sind 24 Stunden gültig; speichern Sie das Ergebnis zeitnah operationId: createMinimaxH3VideoGeneration requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: text_to_video: summary: Text-zu-Video value: 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: 5 quality: 2k aspect_ratio: '16:9' image_to_video: summary: Bild-zu-Video (durch das erste Bild gesteuert) value: model: minimax-h3-image-to-video prompt: >- Den Fokus langsam von der Ramenschüssel im Vordergrund auf die Person im Hintergrund verlagern. Dampf steigt kontinuierlich aus der Schüssel auf und verteilt sich natürlich in der Luft. Die Kamera leicht nach vorn bewegen und dabei Identität der Person und Restaurantumgebung beibehalten. 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: 5 quality: 2k reference_to_video: summary: Multimodale Referenz (Bild + Video + Audio) value: model: minimax-h3-reference-to-video prompt: >- Die Person in Video 1 durch die Figur aus Image 1 ersetzen und Gesicht, Frisur und Kleidung aus Image 1 beibehalten. Bewegung, Rhythmus, Bildkomposition und Kameraführung aus Video 1 vollständig bewahren und den Dialog mit der Stimme aus Audio 1 lippensynchron wiedergeben. image_urls: - >- https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png video_urls: - >- 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: - >- 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: 5 quality: 2k aspect_ratio: adaptive responses: '200': description: Videogenerierungsaufgabe erfolgreich erstellt content: application/json: schema: $ref: '#/components/schemas/VideoGenerationResponse' '400': description: Ungültige Anfrageparameter content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_request message: Invalid request parameters type: invalid_request_error '401': description: Nicht authentifiziert, Token ungültig oder abgelaufen content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: Unzureichendes Guthaben, Aufladung erforderlich content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: Zugriff verweigert content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: >- Token does not have access to model: minimax-h3-text-to-video type: invalid_request_error '429': description: Anfragelimit überschritten content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: Interner Serverfehler content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error components: schemas: VideoGenerationRequest: type: object required: - model - prompt properties: model: type: string description: >- Name des Videogenerierungsmodells. | Modell-ID | Modus | Medienparameter | |:---|:---|:---| | `minimax-h3-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-reference-to-video` | Multimodale Referenz-zu-Video | `image_urls` / `video_urls` / `audio_urls` | enum: - minimax-h3-text-to-video - minimax-h3-image-to-video - minimax-h3-reference-to-video example: minimax-h3-text-to-video prompt: type: string minLength: 1 description: >- Beschreibt das gewünschte Video. Dieses Feld ist erforderlich und darf nicht leer sein. **Anforderungen an den Prompt:** - Chinesisch und Englisch werden unterstützt - Empfohlen sind höchstens `500` chinesische Zeichen oder `1000` englische Wörter; 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 example: >- 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: type: string format: uri description: >- **Unterstützte Modelle:** - Nur `minimax-h3-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 example: >- https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png image_end: type: string format: uri description: >- **Unterstützte Modelle:** - Nur `minimax-h3-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 example: >- https://images.unsplash.com/photo-1515003197210-e0cd71810b5f?auto=format&fit=crop&w=1920&q=85 image_urls: type: array description: >- **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 `1` Referenzbild oder `1` Referenzvideo ist erforderlich - Nur `audio_urls` anzugeben führt zu einem Parameterfehler default: [] maxItems: 9 items: type: string format: uri example: - >- https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png video_urls: type: array description: >- **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 `1` Referenzbild oder `1` Referenzvideo ist erforderlich - Nur `audio_urls` anzugeben führt zu einem Parameterfehler default: [] maxItems: 3 items: type: string format: uri example: - >- 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: type: array description: >- **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 **Kombinationsregeln:** - Referenzaudio darf nicht allein verwendet werden - Bei Verwendung von `audio_urls` muss zusätzlich mindestens `1` Referenzbild oder `1` Referenzvideo angegeben werden default: [] maxItems: 3 items: type: string format: uri example: - >- 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: type: integer description: >- Dauer des Ausgabevideos in Sekunden. Standardwert: `5` Sekunden. **Wertebereich:** - Nur Ganzzahlen von `5` bis einschließlich `15` - Dezimalzahlen, numerische Zeichenketten, `auto` und `-1` werden nicht unterstützt - Die Ausgabedauer wirkt sich direkt auf die Abrechnung aus **Unterstützte Modelle:** - Alle 3 Minimax-H3-Modelle default: 5 minimum: 5 maximum: 15 example: 5 quality: type: string description: >- Auflösung des Ausgabevideos. Standardwert: `2k`. **Verfügbarer Wert:** - `2k`: derzeit die einzige unterstützte Auflösung **Hinweise:** - `768p` ist noch nicht verfügbar und führt zu einem Parameterfehler - Bitrate, Bildrate sowie Video- und Audiocodec werden von der Plattform festgelegt und sind nicht konfigurierbar **Unterstützte Modelle:** - Alle 3 Minimax-H3-Modelle enum: - 2k default: 2k example: 2k aspect_ratio: type: string description: >- Seitenverhältnis des Ausgabevideos. Standardwert ist `adaptive`. **Unterstützte Modelle:** - Unterstützt von `minimax-h3-text-to-video` - Unterstützt von `minimax-h3-reference-to-video` - **Nicht unterstützt von `minimax-h3-image-to-video`; diesen Parameter bei Bild-zu-Video-Anfragen nicht senden** **Verfügbare Werte:** - `adaptive`: Das Modell wählt anhand des Prompts oder der Referenzmedien ein geeignetes Seitenverhältnis - `21:9`: Ultraweit - `16:9`: Querformat - `4:3`: Standard-Querformat - `1:1`: Quadrat - `3:4`: Standard-Hochformat - `9:16`: Hochformat enum: - adaptive - '21:9' - '16:9' - '4:3' - '1:1' - '3:4' - '9:16' default: adaptive example: adaptive callback_url: type: string description: >- 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 3 Minimax-H3-Modelle format: uri example: https://your-domain.com/webhooks/video-task-completed pattern: ^https:// additionalProperties: false VideoGenerationResponse: type: object properties: created: type: integer description: Zeitstempel der Aufgabenerstellung example: 1761313744 id: type: string description: Aufgaben-ID example: task-unified-1774857405-abc123 model: type: string description: Tatsächlich verwendeter Modellname example: minimax-h3-text-to-video object: type: string enum: - video.generation.task description: Spezifischer Aufgabentyp progress: type: integer description: Aufgabenfortschritt in Prozent (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: Aufgabenstatus enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/VideoTaskInfo' description: Detaillierte Informationen zur Videoaufgabe type: type: string enum: - text - image - audio - video description: Ausgabetyp der Aufgabe example: video usage: $ref: '#/components/schemas/VideoUsage' description: Nutzungs- und Abrechnungsinformationen ErrorResponse: type: object properties: error: type: object properties: code: type: string description: Fehlercode-Bezeichner message: type: string description: Fehlerbeschreibung type: type: string description: Fehlertyp VideoTaskInfo: type: object properties: can_cancel: type: boolean description: >- Gibt an, ob die Aufgabe abgebrochen werden kann. Minimax H3 unterstützt keinen Abbruch; immer `false`. example: false enum: - false default: false estimated_time: type: integer description: Geschätzte Fertigstellungszeit (Sekunden) minimum: 0 example: 165 video_duration: type: integer description: Videodauer (Sekunden) example: 8 VideoUsage: type: object description: Nutzungs- und Abrechnungsinformationen properties: billing_rule: type: string description: Abrechnungsregel enum: - per_call - per_token - per_second example: per_second credits_reserved: type: number description: Geschätzter Credit-Verbrauch minimum: 0 example: 50 user_group: type: string description: Benutzergruppenkategorie example: default securitySchemes: bearerAuth: type: http scheme: bearer description: >- ##Alle Schnittstellen erfordern eine Authentifizierung mit Bearer Token## **API Key erhalten:** Besuchen Sie die [API-Key-Verwaltungsseite](https://evolink.ai/dashboard/keys), um Ihren API Key zu erhalten **Fügen Sie ihn im Anfrage-Header hinzu:** ``` Authorization: Bearer YOUR_API_KEY ``` ````