> ## 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 2.0 Fast Image-to-Video

> - 1 Bild eingeben für Startbild-Video, 2 Bilder eingeben für Start-/Endbild-Video, das Modell erkennt dies automatisch
- **Unterstützt jetzt AIGC-Real-Person-Materialien**
- Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Aufgaben-ID [zur Abfrage](/de/api-manual/task-management/get-task-detail)
- Der generierte Video-Link ist 24 Stunden gültig, bitte speichern Sie ihn rechtzeitig



## OpenAPI

````yaml de/api-manual/video-series/seedance2.0/seedance-2.0-fast-image-to-video.json POST /v1/videos/generations
openapi: 3.1.0
info:
  title: Seedance 2.0 Fast Image-to-Video API
  description: >-
    Seedance 2.0 Fast Image-to-Video-API, unterstützt Videogenerierung mit
    Startbild und Start-/Endbild
  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: Seedance 2.0 Fast Image-to-Video
      description: >-
        - 1 Bild eingeben für Startbild-Video, 2 Bilder eingeben für
        Start-/Endbild-Video, das Modell erkennt dies automatisch

        - **Unterstützt jetzt AIGC-Real-Person-Materialien**

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

        - Der generierte Video-Link ist 24 Stunden gültig, bitte speichern Sie
        ihn rechtzeitig
      operationId: createSeedance20FastImageToVideo
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VideoGenerationRequest'
            examples:
              first_frame:
                summary: Startbild-Video
                value:
                  model: seedance-2.0-fast-image-to-video
                  prompt: >-
                    The camera slowly zooms in, the scene gradually comes to
                    life
                  image_urls:
                    - https://example.com/first-frame.jpg
                  duration: 5
                  aspect_ratio: adaptive
              first_last_frame:
                summary: Start-/Endbild-Video
                value:
                  model: seedance-2.0-fast-image-to-video
                  prompt: A smooth transition between two scenes
                  image_urls:
                    - https://example.com/first.jpg
                    - https://example.com/last.jpg
                  duration: 6
                  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:
                    seedance-2.0-fast-image-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
        - image_urls
      properties:
        model:
          type: string
          description: Name des Videogenerierungsmodells
          enum:
            - seedance-2.0-fast-image-to-video
          default: seedance-2.0-fast-image-to-video
          example: seedance-2.0-fast-image-to-video
        prompt:
          type: string
          description: >-
            Textprompt zur Beschreibung des gewünschten Videos. Unterstützt
            Chinesisch und Englisch, empfohlen max. 500 Zeichen auf Chinesisch,
            max. 1000 Wörter auf Englisch. Maximale Prompt-Länge: 10000 Tokens


            **Hinweis:**

            - Dieses Modell unterstützt keine Eingabe von `video_urls` oder
            `audio_urls`
          example: The camera slowly zooms in, the scene gradually comes to life
        image_urls:
          type: array
          description: >-
            Bild-URL-Array, **1-2 Bilder**


            **Bildanzahl und Verhalten:**


            | Bildanzahl | Verhalten | Rolle |

            |:--------:|------|------|

            | 1 Bild | Startbild-Video | Automatisch als `first_frame` gesetzt |

            | 2 Bilder | Start-/Endbild-Video | Bild 1 → `first_frame`, Bild 2 →
            `last_frame` |


            **Bildanforderungen:**

            - Unterstützte Formate: `.jpeg`, `.png`, `.webp`

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

            - Breite/Höhe in Pixel: `300` ~ `6000` px

            - Einzelbildgröße: maximal `30MB`

            - Gesamtgröße des Anfragekörpers maximal `64MB`, verwenden Sie bei
            großen Dateien keine Base64-Kodierung

            - Bei Start-/Endbildern können beide Bilder identisch sein. Bei
            unterschiedlichen Seitenverhältnissen wird das Startbild als
            Referenz verwendet, das Endbild wird automatisch zugeschnitten

            - Bild-URLs müssen für den Server direkt zugänglich sein
          items:
            type: string
            format: uri
          minItems: 1
          maxItems: 2
          example:
            - https://example.com/first-frame.jpg
        duration:
          type: integer
          description: |-
            Videodauer (Sekunden), Standard ist `5` Sekunden

            **Hinweise:**
            - Unterstützt beliebige Ganzzahlwerte zwischen `4` und `15` Sekunden
            - Die Dauer wirkt sich direkt auf die Abrechnung aus
          default: 5
          minimum: 4
          maximum: 15
          example: 5
        quality:
          type: string
          description: |-
            Videoauflösung, Standard ist `720p`

            **Verfügbare Werte:**
            - `480p`: Niedrigere Auflösung, günstigerer Preis
            - `720p`: Standardauflösung, dies ist der Standardwert
            - `1080p`: Ultra-HD-Auflösung, **demnächst verfügbar**
          enum:
            - 480p
            - 720p
          default: 720p
          example: 720p
        aspect_ratio:
          type: string
          description: >-
            Video-Seitenverhältnis, Standard ist `16:9`


            **Verfügbare Werte:**

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

            - `adaptive`: Wählt automatisch das nächstliegende Seitenverhältnis
            basierend auf dem Startbild


            **Pixelwerte pro Auflösung:**


            | Seitenverhältnis | 480p | 720p |

            |:------:|:----:|:----:|

            | 16:9 | 864×496 | 1280×720 |

            | 4:3 | 752×560 | 1112×834 |

            | 1:1 | 640×640 | 960×960 |

            | 3:4 | 560×752 | 834×1112 |

            | 9:16 | 496×864 | 720×1280 |

            | 21:9 | 992×432 | 1470×630 |
          enum:
            - '16:9'
            - '9:16'
            - '1:1'
            - '4:3'
            - '3:4'
            - '21:9'
            - adaptive
          default: '16:9'
          example: adaptive
        generate_audio:
          type: boolean
          description: >-
            Ob synchronisiertes Audio generiert werden soll, Standard ist `true`


            **Verfügbare Werte:**

            - `true`: Video enthält synchronisiertes Audio, keine zusätzlichen
            Kosten

            - `false`: Stummes Video ausgeben
          default: true
          example: true
        content_filter:
          type: boolean
          description: >-
            Inhaltsfilter, Standard ist `true`


            **Verfügbare Werte:**

            - `true`: Standardmäßige Inhaltssicherheitsprüfung, dies ist der
            Standard

            - `false`: Lockert die Inhaltsbeschränkungen, Abrechnung mit +10%
            (`1.1x`). Illegale und verbotene Inhalte werden unabhängig von
            dieser Einstellung immer durchgesetzt
          default: true
          example: true
        callback_url:
          type: string
          description: >-
            HTTPS-Callback-URL nach Aufgabenabschluss


            **Callback-Zeitpunkte:**

            - Wird ausgelöst bei Aufgabenabschluss (completed), Fehler (failed)
            oder Abbruch (cancelled)

            - 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
    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: seedance-2.0-fast-image-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: Ob die Aufgabe abgebrochen werden kann
          example: true
        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

        ```

````