> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Hailuo-2.3 Videogenerierung

> - Hailuo 2.3 (MiniMax-Hailuo-2.3) unterstützt T2V (Text-zu-Video) und I2V (Bild-zu-Video) Modi
- Automatische Moduserkennung: 0 Bilder=T2V, 1 Bild=I2V
- SOTA-Instruktionsbefolgung, hochwertige Ausgabe
- Unterstützt 15 Kamerabewegungsbefehle wie `[Pan left]`, `[Push in]`, `[Static shot]`
- Asynchrone Verarbeitung, verwenden Sie die zurückgegebene Aufgaben-ID zum [Statusabfragen](/de/api-manual/task-management/get-task-detail)
- Generierte Video-Links sind 24 Stunden gültig, bitte umgehend speichern



## OpenAPI

````yaml de/api-manual/video-series/hailuo/hailuo-2-3-video-generate.json POST /v1/videos/generations
openapi: 3.1.0
info:
  title: Hailuo 2.3 API
  description: >-
    Erstellen Sie Videogenerierungsaufgaben mit dem MiniMax Hailuo 2.3 Modell,
    unterstützt T2V- und I2V-Modi
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.evolink.ai
    description: Produktion
security:
  - bearerAuth: []
tags:
  - name: Videogenerierung
    description: APIs zur KI-Videogenerierung
paths:
  /v1/videos/generations:
    post:
      tags:
        - Videogenerierung
      summary: Hailuo 2.3 API
      description: >-
        - Hailuo 2.3 (MiniMax-Hailuo-2.3) unterstützt T2V (Text-zu-Video) und
        I2V (Bild-zu-Video) Modi

        - Automatische Moduserkennung: 0 Bilder=T2V, 1 Bild=I2V

        - SOTA-Instruktionsbefolgung, hochwertige Ausgabe

        - Unterstützt 15 Kamerabewegungsbefehle wie `[Pan left]`, `[Push in]`,
        `[Static shot]`

        - Asynchrone Verarbeitung, verwenden Sie die zurückgegebene Aufgaben-ID
        zum [Statusabfragen](/de/api-manual/task-management/get-task-detail)

        - Generierte Video-Links sind 24 Stunden gültig, bitte umgehend
        speichern
      operationId: createVideoGeneration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VideoGenerationRequest'
            examples:
              text_to_video:
                summary: Text-zu-Video (T2V)
                value:
                  model: MiniMax-Hailuo-2.3
                  prompt: A beautiful sunset over the ocean [Static shot]
      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 autorisiert, ungültiges oder abgelaufenes Token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: unauthorized
                  message: Invalid or expired token
                  type: authentication_error
        '402':
          description: Unzureichendes Kontingent, 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-Hailuo-2.3'
                  type: invalid_request_error
        '429':
          description: Ratenlimit ü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
          default: MiniMax-Hailuo-2.3
          example: MiniMax-Hailuo-2.3
        prompt:
          type: string
          description: >-
            Prompt zur Beschreibung von Videoinhalt und Kamerabewegung.
            Erforderlich für T2V, optional für I2V. Max. 2000 Zeichen


            **15 Kamerabefehle:**

            - Truck: `[Truck left]`, `[Truck right]`

            - Pan: `[Pan left]`, `[Pan right]`

            - Dolly: `[Push in]`, `[Pull out]`

            - Pedestal: `[Pedestal up]`, `[Pedestal down]`

            - Tilt: `[Tilt up]`, `[Tilt down]`

            - Zoom: `[Zoom in]`, `[Zoom out]`

            - Spezial: `[Shake]`

            - Verfolgung: `[Tracking shot]`

            - Statisch: `[Static shot]`


            **Verwendung:**

            - Kombiniert: Mehrere Befehle in einem `[]` werden gleichzeitig
            ausgeführt, z.B. `[Pan left,Pedestal up]`, max. 3 empfohlen

            - Sequenziell: Befehle werden in Textreihenfolge ausgeführt, z.B.
            `...langsam [Push in], dann schnell [Pull out]`
          example: A beautiful sunset over the ocean [Static shot]
          maxLength: 2000
        image_urls:
          type: array
          description: |-
            Referenzbild-URLs für I2V-Modus, optional

            **Moduserkennung:**
            - 0 Bilder = T2V (Text-zu-Video)
            - 1 Bild = I2V (Bild-zu-Video)

            **Anforderungen:**
            - Bildgröße: max. 20MB
            - Formate: JPG, JPEG, PNG, WebP
            - Seitenverhältnis: 2:5 bis 5:2
            - Kurze Kante > 300px
          items:
            type: string
            format: uri
          maxItems: 1
          example:
            - https://example.com/image.jpg
        quality:
          type: string
          description: |-
            Videoauflösung

            **Unterstützt nach Modus:**
            - I2V: 768p, 1080p
            - T2V: 768p, 1080p

            **Dauer & Auflösung:**
            - 768p: 6s, 10s
            - 1080p: nur 6s
          enum:
            - 768p
            - 1080p
          default: 768p
          example: 768p
        duration:
          type: integer
          description: |-
            Videodauer (Sekunden)
            - 6 Sekunden (Standard)
            - 10 Sekunden (nicht verfügbar für 1080p)
          enum:
            - 6
            - 10
          default: 6
          example: 10
        model_params:
          type: object
          description: Modellspezifische Parameter
          properties:
            prompt_optimizer:
              type: boolean
              description: >-
                Prompt automatisch optimieren. Auf false setzen für präzise
                Kontrolle
              default: true
              example: true
            fast_pretreatment:
              type: boolean
              description: >-
                Schnelle Vorverarbeitung aktivieren, um die Optimierungszeit zu
                reduzieren
              default: false
              example: false
        callback_url:
          type: string
          description: >-
            HTTPS-Callback-URL für Aufgabenabschluss


            **Callback-Zeitpunkt:**

            - Wird ausgelöst, wenn die Aufgabe abgeschlossen, fehlgeschlagen
            oder abgebrochen wurde

            - Wird nach Abrechnungsbestätigung gesendet


            **Sicherheitsbeschränkungen:**

            - Nur HTTPS-Protokoll

            - Interne IP-Adressen sind verboten (127.0.0.1, 10.x.x.x,
            172.16-31.x.x, 192.168.x.x, etc.)

            - URL-Länge darf `2048` Zeichen nicht überschreiten


            **Callback-Mechanismus:**

            - Timeout: `10` Sekunden

            - Maximal `3` Wiederholungsversuche nach Fehler (nach `1`/`2`/`4`
            Sekunden nach Fehler)

            - Callback-Antwortformat ist konsistent mit der Aufgabenabfrage-API

            - 2xx-Statuscode gilt als erfolgreich, andere Codes lösen
            Wiederholung aus
          format: uri
          example: https://your-domain.com/webhooks/video-task-completed
    VideoGenerationResponse:
      type: object
      properties:
        created:
          type: integer
          description: Zeitstempel der Aufgabenerstellung
          example: 1757169743
        id:
          type: string
          description: Aufgaben-ID
          example: task-unified-1757169743-7cvnl5zw
        model:
          type: string
          description: Verwendeter Modellname
          example: MiniMax-Hailuo-2.3
        object:
          type: string
          enum:
            - video.generation.task
          description: Aufgabentyp
        progress:
          type: integer
          description: Aufgabenfortschritt (0-100)
          minimum: 0
          maximum: 100
          example: 0
        status:
          type: string
          description: Aufgabenstatus
          enum:
            - pending
            - processing
            - completed
            - failed
          example: pending
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: Fehlercode-Bezeichner
            message:
              type: string
              description: Fehlerbeschreibung
            type:
              type: string
              description: Fehlertyp
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        ##Alle APIs erfordern Bearer-Token-Authentifizierung##


        **API-Schlüssel erhalten:**


        Besuchen Sie die
        [API-Schlüsselverwaltungsseite](https://evolink.ai/dashboard/keys), um
        Ihren API-Schlüssel zu erhalten


        **Zum Anfrage-Header hinzufügen:**

        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````