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

# Seedance-1.5-Pro Videogenerierung

> - Das Seedance 1.5 Pro (seedance-1.5-pro) Modell unterstützt mehrere Generierungsmodi, einschließlich Text-zu-Video, Bild-zu-Video und Erst-Letzt-Bild
- Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Aufgaben-ID zum [Abfragen](/de/api-manual/task-management/get-task-detail)
- Generierte Videolinks sind 24 Stunden gültig, bitte speichern Sie diese umgehend



## OpenAPI

````yaml de/api-manual/video-series/seedance1.5/seedance-1.5-pro-video-generate.json POST /v1/videos/generations
openapi: 3.1.0
info:
  title: seedance-1.5-pro API
  description: >-
    Videogenerierungsaufgaben mit KI-Modellen erstellen, unterstützt
    Text-zu-Video-Generierungsmodus
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.evolink.ai
    description: Produktionsumgebung
security:
  - bearerAuth: []
tags:
  - name: Videogenerierung
    description: KI-Videogenerierung zugehörige APIs
paths:
  /v1/videos/generations:
    post:
      tags:
        - Videogenerierung
      summary: seedance-1.5-pro API
      description: >-
        - Das Seedance 1.5 Pro (seedance-1.5-pro) Modell unterstützt mehrere
        Generierungsmodi, einschließlich Text-zu-Video, Bild-zu-Video und
        Erst-Letzt-Bild

        - Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene
        Aufgaben-ID zum
        [Abfragen](/de/api-manual/task-management/get-task-detail)

        - Generierte Videolinks sind 24 Stunden gültig, bitte speichern Sie
        diese umgehend
      operationId: createVideoGeneration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VideoGenerationRequest'
            examples:
              text_to_video_basic:
                summary: Text zu Video (Basis)
                value:
                  model: seedance-1.5-pro
                  prompt: A cat playing piano
      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: seedance-1.5-pro'
                  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
          enum:
            - seedance-1.5-pro
          default: seedance-1.5-pro
          example: seedance-1.5-pro
        prompt:
          type: string
          description: >-
            Prompt, der das zu generierende Video beschreibt, begrenzt auf 2000
            Token
          example: A cat playing piano
          maxLength: 2000
        image_urls:
          type: array
          description: >-
            Referenzbild-URL-Liste für die Bild-zu-Video-Funktionalität


            **Moduserkennung:**

            - 0 Bilder = Text-zu-Video

            - 1 Bild = Bild-zu-Video

            - 2 Bilder = Erst-Letzt-Bild


            **Hinweis:**

            - Anzahl der unterstützten Bilder pro Anfrage: `2` Bilder

            - Bildgröße: Nicht mehr als `10MB`

            - Unterstützte Dateiformate: `.jpg`, `.jpeg`, `.png`, `.webp`

            - Seitenverhältnis (Breite/Höhe): `0.4` ~ `2.5`

            - Breite und Höhe: `300` ~ `6000` px

            - Bild-URLs müssen vom Server direkt aufrufbar sein, oder die URL
            sollte beim Zugriff einen direkten Download auslösen (typischerweise
            enden diese URLs mit Bilderweiterungen wie `.png`, `.jpg`)
          items:
            type: string
            format: uri
          maxItems: 2
          example:
            - https://example.com/image.jpg
        duration:
          type: integer
          description: >-
            Gibt die Dauer des generierten Videos an (in Sekunden), Standardwert
            ist `5` Sekunden


            **Hinweis:**

            - Unterstützt jeden ganzzahligen Wert zwischen `4` und `12` Sekunden

            - Die Abrechnung einer einzelnen Anfrage basiert auf dem
            `duration`-Wert; längere Dauern führen zu höheren Kosten
          minimum: 4
          maximum: 12
        quality:
          type: string
          description: >-
            Videoauflösung, Standardwert ist `720p`


            **Hinweis:**

            - `480p`: Niedrigere Auflösung, günstigerer Preis

            - `720p`: Standardauflösung, Standardpreis, dies ist der
            Standardwert

            - `1080p`: Hohe Auflösung, höherer Preis
          enum:
            - 480p
            - 720p
            - 1080p
          example: 720p
        aspect_ratio:
          type: string
          description: >-
            Video-Seitenverhältnis


            **Unterstützte Werte:**

            - `16:9` (Querformat), `9:16` (Hochformat), `1:1` (Quadrat), `4:3`,
            `3:4`, `21:9` (Ultrabreit), `adaptive`

            - Standardwert: `16:9`
          example: '16:9'
        generate_audio:
          type: boolean
          description: >-
            Ob Audio generiert werden soll, die Aktivierung erhöht die Kosten,
            Standardwert ist `true`


            **Optionen:**

            - `true`: Die Modellausgabe enthält synchronisiertes Audio. Seedance
            1.5 Pro kann automatisch passende Stimme, Soundeffekte und
            Hintergrundmusik basierend auf Textprompts und visuellem Inhalt
            generieren. Es wird empfohlen, Dialoge in doppelte Anführungszeichen
            zu setzen, um die Audiogenerierung zu optimieren. Beispiel: Der Mann
            hielt die Frau an und sagte: "Denk daran, du darfst niemals mit dem
            Finger auf den Mond zeigen."

            - `false`: Die Modellausgabe ist stumm
          default: true
          example: true
        callback_url:
          type: string
          description: >-
            HTTPS-Callback-URL nach Aufgabenabschluss


            **Callback-Zeitpunkt:**

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

            - Wird nach Abschluss der Abrechnungsbestätigung gesendet


            **Sicherheitsbeschränkungen:**

            - Nur HTTPS-Protokoll wird unterstützt

            - Callbacks an interne Netzwerk-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 darf `2048` Zeichen nicht überschreiten


            **Callback-Mechanismus:**

            - Timeout: `10` Sekunden

            - Maximal `3` Wiederholungsversuche nach Fehlschlag (Wiederholungen
            erfolgen nach `1`/`2`/`4` Sekunden nach dem Fehlschlag)

            - Das Format des Callback-Antwortkörpers entspricht dem
            Antwortformat der Aufgabenabfrage-API

            - Callback-URL, die einen 2xx-Statuscode zurückgibt, gilt als
            erfolgreich; andere Statuscodes lösen Wiederholungsversuche aus
          format: uri
          example: https://your-domain.com/webhooks/video-task-completed
    VideoGenerationResponse:
      type: object
      properties:
        created:
          type: integer
          description: Zeitstempel der Aufgabenerstellung
          example: 1761313744
        id:
          type: string
          description: Aufgaben-ID
          example: task-unified-1761313744-vux2jw0k
        model:
          type: string
          description: Tatsächlich verwendeter Modellname
          example: seedance-1.5-pro
        object:
          type: string
          enum:
            - video.generation.task
          description: Spezifischer Typ der Aufgabe
        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: Ob die Aufgabe abgebrochen werden kann
          example: true
        estimated_time:
          type: integer
          description: Geschätzte Abschlusszeit (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_call
        credits_reserved:
          type: number
          description: Geschätzter Guthabenverbrauch
          minimum: 0
          example: 8
        user_group:
          type: string
          description: Benutzergruppenkategorie
          example: default
  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

        ```

````