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

# Wan2.7 Text-zu-Video

> - Das WAN2.7 (wan2.7-text-to-video)-Modell unterstützt Text-zu-Video-Generierung und erzeugt aus Textprompts flüssige Videos
- **Mehrfach-Einstellungs-Erzählung:** Steuerung der Aufnahmestruktur über natürliche Sprache im `prompt`
  - Einzelaufnahme: "Generiere ein Video mit einer einzigen Aufnahme" im Prompt angeben
  - Mehrere Aufnahmen: "Generiere ein Video mit mehreren Aufnahmen" oder Aufnahmen mit Zeitstempeln (z. B. "Aufnahme 1 [0-3s] Totale: nächtliche Regenstraße")
  - Standard: ohne Angabe interpretiert das Modell den `prompt`-Inhalt eigenständig
- **Audioverarbeitung:**
  - Mit `audio_urls`: das Modell verwendet das übergebene Audio als treibende Quelle
  - Ohne `audio_urls`: das Modell erzeugt automatisch passende Hintergrundmusik oder Soundeffekte zum Bildinhalt
- Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Task-ID für die [Statusabfrage](/de/api-manual/task-management/get-task-detail)
- Generierte Videolinks sind 24 Stunden gültig, bitte zeitnah speichern



## OpenAPI

````yaml de/api-manual/video-series/wan2.7/wan2.7-text-to-video.json POST /v1/videos/generations
openapi: 3.1.0
info:
  title: wan2.7-text-to-video API
  description: >-
    Generieren Sie Videos aus Text mit dem WAN2.7-Modell mit vereinfachter
    Modellparameter-Konfiguration
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.evolink.ai
    description: Produktionsumgebung
security:
  - bearerAuth: []
paths:
  /v1/videos/generations:
    post:
      tags:
        - Videogenerierung
      summary: wan2.7-text-to-video API
      description: >-
        - Das WAN2.7 (wan2.7-text-to-video)-Modell unterstützt
        Text-zu-Video-Generierung und erzeugt aus Textprompts flüssige Videos

        - **Mehrfach-Einstellungs-Erzählung:** Steuerung der Aufnahmestruktur
        über natürliche Sprache im `prompt`
          - Einzelaufnahme: "Generiere ein Video mit einer einzigen Aufnahme" im Prompt angeben
          - Mehrere Aufnahmen: "Generiere ein Video mit mehreren Aufnahmen" oder Aufnahmen mit Zeitstempeln (z. B. "Aufnahme 1 [0-3s] Totale: nächtliche Regenstraße")
          - Standard: ohne Angabe interpretiert das Modell den `prompt`-Inhalt eigenständig
        - **Audioverarbeitung:**
          - Mit `audio_urls`: das Modell verwendet das übergebene Audio als treibende Quelle
          - Ohne `audio_urls`: das Modell erzeugt automatisch passende Hintergrundmusik oder Soundeffekte zum Bildinhalt
        - Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene
        Task-ID für die
        [Statusabfrage](/de/api-manual/task-management/get-task-detail)

        - Generierte Videolinks sind 24 Stunden gültig, bitte zeitnah speichern
      operationId: createWan27TextToVideoGeneration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Wan27TextToVideoRequest'
            examples:
              single_shot:
                summary: Einzelaufnahme Text-zu-Video
                value:
                  model: wan2.7-text-to-video
                  prompt: Ein kleines Kätzchen läuft im Mondlicht
                  aspect_ratio: '16:9'
                  duration: 5
              multi_shot_storyboard:
                summary: Storyboard mit mehreren Aufnahmen
                value:
                  model: wan2.7-text-to-video
                  prompt: >-
                    Eine spannende Detektivverfolgung. Aufnahme 1 [0-3s] Totale:
                    nächtliche Regenstraße, blinkende Neonlichter. Aufnahme 2
                    [3-6s] Halbnah: Detektiv betritt ein altes Gebäude. Aufnahme
                    3 [6-9s] Nahaufnahme: entschlossene Augen, Sirenen in der
                    Ferne. Aufnahme 4 [9-12s] Halbnah: vorsichtig durch dunklen
                    Korridor. Aufnahme 5 [12-15s] Nahaufnahme: er entdeckt den
                    Schlüsselhinweis.
                  aspect_ratio: '16:9'
                  duration: 15
              with_audio:
                summary: Mit treibendem Audio
                value:
                  model: wan2.7-text-to-video
                  prompt: >-
                    Ein winziger süßer Cartoon-Katzen-General in goldener
                    Rüstung reitet ein Schlachtross und rezitiert ein
                    klassisches Gedicht
                  audio_urls:
                    - https://example.com/recital.mp3
                  duration: 10
              with_negative_prompt:
                summary: Mit Negativprompt
                value:
                  model: wan2.7-text-to-video
                  prompt: Ein kleines Kätzchen läuft im Mondlicht
                  negative_prompt: Blumen
      responses:
        '200':
          description: Video-Aufgabe 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 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: Keine Zugriffsberechtigung
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: model_access_denied
                  message: 'Token does not have access to model: wan2.7-text-to-video'
                  type: invalid_request_error
        '429':
          description: Anfragerate ü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:
    Wan27TextToVideoRequest:
      required:
        - model
        - prompt
      type: object
      properties:
        model:
          type: string
          description: Modellname, muss `wan2.7-text-to-video` sein
          enum:
            - wan2.7-text-to-video
          example: wan2.7-text-to-video
        prompt:
          type: string
          description: >-
            Textprompt für die Videogenerierung. Unterstützt Chinesisch und
            Englisch; jedes Zeichen/jeder Buchstabe zählt als 1, Überschuss wird
            automatisch gekürzt. Maximale Länge: 5000 Zeichen


            **Mehrfach-Einstellungs-Erzählung:** Steuerung der Aufnahmestruktur
            über natürliche Sprache

            - Einzelaufnahme: "Generiere ein Video mit einer einzigen Aufnahme"
            im Prompt angeben

            - Mehrere Aufnahmen: "Generiere ein Video mit mehreren Aufnahmen"
            oder zeitgestempelte Aufnahmenliste (z. B. "Aufnahme 1 [0-3s]")
          maxLength: 5000
          example: Ein kleines Kätzchen läuft im Mondlicht
        negative_prompt:
          type: string
          description: >-
            Negativprompt zur Beschreibung von Inhalten, die im Video vermieden
            werden sollen. Unterstützt Chinesisch und Englisch. Maximale Länge
            500 Zeichen; Überschuss wird automatisch gekürzt
          maxLength: 500
          example: Unscharf, geringe Qualität
        audio_urls:
          type: array
          items:
            type: string
            format: uri
          minItems: 1
          maxItems: 1
          description: >-
            Treibende Audio-URL-Liste (optional). **Derzeit wird nur 1 Element
            unterstützt**


            **Verhalten:**

            - Bereitgestellt: das Modell verwendet dieses Audio als treibende
            Quelle

            - Weggelassen: das Modell erzeugt automatisch passende
            Hintergrundmusik oder Soundeffekte zum Bildinhalt


            **Formatanforderungen:**

            - Unterstützte Formate: `wav`, `mp3`

            - Dauer: `2 ~ 30` Sekunden

            - Dateigröße: max. `15MB`


            **Kürzungsverhalten:**

            - Wenn die Audiolänge `duration` überschreitet, werden die ersten N
            Sekunden verwendet, der Rest wird verworfen

            - Wenn die Audiolänge kürzer als die Videodauer ist, ist der
            Restteil stumm. Beispiel: bei 3s Audio und 5s Video sind die ersten
            3s mit Ton, die letzten 2s ohne Ton
          example:
            - https://example.com/audio.mp3
        quality:
          type: string
          description: |-
            Videoqualität, Standard: `720p`

            **Optionen:**
            - `720p`: Standardqualität, Standardpreis (Standard)
            - `1080p`: Hohe Qualität, höherer Preis
          enum:
            - 720p
            - 1080p
          default: 720p
          example: 720p
        aspect_ratio:
          type: string
          description: >-
            Seitenverhältnis des Videos, Standard: `16:9`


            **Ausgabeauflösung pro Qualitätsstufe:**


            | Qualität | 16:9 | 9:16 | 1:1 | 4:3 | 3:4 |

            | --- | --- | --- | --- | --- | --- |

            | 720p | 1280×720 | 720×1280 | 960×960 | 1104×832 | 832×1104 |

            | 1080p | 1920×1080 | 1080×1920 | 1440×1440 | 1648×1248 | 1248×1648
            |
          enum:
            - '16:9'
            - '9:16'
            - '1:1'
            - '4:3'
            - '3:4'
          default: '16:9'
          example: '16:9'
        duration:
          type: number
          description: >-
            Videodauer in Sekunden, Bereich 2-15


            **Hinweis:**

            - Jeder ganzzahlige Wert zwischen `2~15` Sekunden wird unterstützt

            - Die endgültige Abrechnung erfolgt anhand der tatsächlich
            generierten Videodauer
          minimum: 2
          maximum: 15
          default: 5
          example: 5
        seed:
          type: integer
          description: >-
            Zufallsseed, standardmäßig zufällig


            **Hinweise:**

            - Bereich: `1` ~ `2147483647`

            - Ein fester Seed reduziert beim Iterieren am Prompt die Variation
            und verbessert die Reproduzierbarkeit
          minimum: 1
          maximum: 2147483647
          example: 42
        prompt_extend:
          type: boolean
          description: >-
            Ob die intelligente Prompt-Umschreibung aktiviert werden soll. Wenn
            aktiviert, optimiert ein großes Modell den Prompt, was die
            Ergebnisse für einfache oder unzureichend beschreibende Prompts
            deutlich verbessert.


            **Hinweis:** Standard ist `false` — wird der Parameter weggelassen
            oder `false` gesendet, erfolgt keine Umschreibung. Senden Sie
            explizit `true`, um die Umschreibung zu aktivieren.
          default: false
          example: true
        callback_url:
          type: string
          description: >-
            HTTPS-Callback-URL für den Aufgabenabschluss


            **Callback-Zeitpunkt:**

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

            - Wird nach Abrechnungsbestätigung gesendet


            **Sicherheitseinschränkungen:**

            - Nur HTTPS wird 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 max. `2048` Zeichen


            **Callback-Mechanismus:**

            - Timeout: `10` Sekunden

            - Bis zu `3` Wiederholungen nach Fehlschlag (jeweils nach
            `1`/`2`/`4` Sekunden)

            - Callback-Antwortformat ist identisch mit der Task-Query-API

            - 2xx-Statuscodes gelten als erfolgreich, andere lösen
            Wiederholungen 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: Tatsächlich verwendeter Modellname
          example: wan2.7-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 Video-Aufgabe
        type:
          type: string
          enum:
            - text
            - image
            - audio
            - video
          description: Ausgabetyp der Aufgabe
          example: video
        usage:
          $ref: '#/components/schemas/Usage'
          description: Nutzungs- und Abrechnungsinformationen
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: Fehlercode-Identifikator
            message:
              type: string
              description: Fehlerbeschreibung
            type:
              type: string
              description: Fehlertyp
    VideoTaskInfo:
      type: object
      properties:
        can_cancel:
          type: boolean
          description: Ob die Aufgabe abgebrochen werden kann
          example: true
        estimated_time:
          type: integer
          description: Geschätzte Fertigstellungszeit (Sekunden)
          minimum: 0
          example: 120
    Usage:
      type: object
      description: Nutzungs- und Abrechnungsinformationen
      properties:
        billing_rule:
          type: string
          description: Abrechnungsregel
          enum:
            - per_call
            - per_token
            - per_second
          example: per_call
        credits_reserved:
          type: number
          description: Geschätzt zu verbrauchende Credits
          minimum: 0
          example: 5
        user_group:
          type: string
          description: Benutzergruppen-Kategorie
          enum:
            - default
            - vip
          example: default
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        ## Alle APIs erfordern Bearer-Token-Authentifizierung ##


        **API-Schlüssel erhalten:**


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


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

        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````