> ## 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 Text-to-Video

> - Video aus einer nicht leeren Texteingabe erzeugen
- Ausgabedauer: `5`–`15` Sekunden; derzeit wird nur `2k` unterstützt
- Keine Bild-, Video- oder Audioeingaben
- Asynchrone Verarbeitung; Status mit der zurückgegebenen Task-ID [abfragen](/de/api-manual/task-management/get-task-detail)
- Generierte Video-URLs sind 24 Stunden gültig



## OpenAPI

````yaml de/api-manual/video-series/minimax/minimax-h3-text-to-video.json POST /v1/videos/generations
openapi: 3.1.0
info:
  title: Minimax H3 Text-to-Video API
  description: Minimax H3 Text-zu-Video-API zur Erzeugung von 2K-Videos aus Text
  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 Text-to-Video
      description: >-
        - Video aus einer nicht leeren Texteingabe erzeugen

        - Ausgabedauer: `5`–`15` Sekunden; derzeit wird nur `2k` unterstützt

        - Keine Bild-, Video- oder Audioeingaben

        - Asynchrone Verarbeitung; Status mit der zurückgegebenen Task-ID
        [abfragen](/de/api-manual/task-management/get-task-detail)

        - Generierte Video-URLs sind 24 Stunden gültig
      operationId: createMinimaxH3TextToVideo
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VideoGenerationRequest'
            examples:
              basic:
                summary: Einfaches Text-to-Video
                value:
                  model: minimax-h3-text-to-video
                  prompt: >-
                    Epischer Weltraumoper-Kinotrailer: Eine Kapitänin steht
                    allein vor einem riesigen Beobachtungsfenster, während sich
                    draußen die letzte Flotte sammelt. Die Flotte springt in
                    einem blendenden Lichtblitz davon, die Brücke bebt; als das
                    Licht erlischt, bleibt sie allein im stillen Weltraum
                    zurück. Filmische Beleuchtung, langsame Kamerafahrt,
                    großartige und zugleich zurückhaltende Stimmung.
                  duration: 5
                  quality: 2k
                  aspect_ratio: '16:9'
      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
          enum:
            - minimax-h3-text-to-video
          default: minimax-h3-text-to-video
          example: minimax-h3-text-to-video
        prompt:
          type: string
          minLength: 1
          description: >-
            Beschreibt das gewünschte Video.


            **Anforderungen an den Prompt:**

            - Erforderlich und darf nicht leer sein

            - 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


            **Eingabebeschränkungen:**

            - Dieses Modell erzeugt Videos ausschließlich aus Text

            - `image_start`, `image_end`, `image_urls`, `video_urls` und
            `audio_urls` werden nicht unterstützt

            - Die Angabe eines dieser Medienfelder führt zu einem
            Parameterfehler
          example: >-
            Epischer Weltraumoper-Kinotrailer: Eine Kapitänin steht allein vor
            einem riesigen Beobachtungsfenster, während sich draußen die letzte
            Flotte sammelt. Die Flotte springt in einem blendenden Lichtblitz
            davon, die Brücke bebt; als das Licht erlischt, bleibt sie allein im
            stillen Weltraum zurück. Filmische Beleuchtung, langsame
            Kamerafahrt, großartige und zugleich zurückhaltende Stimmung.
        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
          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
          enum:
            - 2k
          default: 2k
          example: 2k
        aspect_ratio:
          type: string
          description: >-
            Seitenverhältnis des Ausgabevideos. Standardwert: `adaptive`.


            **Verfügbare Werte:**

            - `adaptive`: Das Modell wählt anhand des Prompts ein geeignetes
            Seitenverhältnis

            - `21:9`: Ultra-Breitbild

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

        ```

````