# Seedance 2.0 API Vollständige API-Referenz für die Seedance 2.0-Videogenerierungsmodelle von ByteDance. ## Modellvarianten Diese API unterstützt sechs Modellvarianten: | Modell | ID | Beschreibung | |-------|-----|-------------| | **Seedance 2.0 Text to Video** | `seedance-v2.0-text-to-video` | Hochwertige Videogenerierung aus Text | | **Seedance 2.0 Image to Video** | `seedance-v2.0-image-to-video` | Bildanimation mit Bewegungssteuerung | | **Seedance 2.0 Reference to Video** | `seedance-v2.0-reference-to-video` | Videogenerierung mithilfe eines Referenzvideos | | **Seedance 2.0 Fast Text to Video** | `seedance-v2.0-fast-text-to-video` | Schnellere Videogenerierung aus Text | | **Seedance 2.0 Fast Image to Video** | `seedance-v2.0-fast-image-to-video` | Schnellere Videogenerierung aus Bildern | | **Seedance 2.0 Fast Reference to Video** | `seedance-v2.0-fast-reference-to-video` | Schnellere referenzgestützte Videogenerierung | ## Kurzvergleich | Funktion | Standardmodelle | Fast-Modelle | |---------|-----------------|-------------| | Qualität | Höhere Qualität | Auf Geschwindigkeit optimiert | | Verarbeitungszeit | 3-8 Minuten | 1-4 Minuten | | Dauerbereich | 4-15 Sekunden | 4-15 Sekunden | | Auflösungsoptionen | 480p, 720p, 1080p, 4k | 480p, 720p | | Referenzmedien | Bilder, Videos und Audios für Reference-to-Video | Bilder, Videos und Audios für Fast Reference-to-Video | ### Unterstützte Seitenverhältnisse `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` ### Auflösungsoptionen | Auflösung | Beschreibung | |------------|-------------| | `480p` | Standardauflösung, schnellere Verarbeitung | | `720p` | Hohe Auflösung, ausgewogene Qualität und Geschwindigkeit | | `1080p` | Full HD, für alle Standardmodelle von Seedance 2.0 verfügbar | | `4k` | Ultra HD, für alle Standardmodelle von Seedance 2.0 verfügbar | ## Seedance 2.0 Text zu Video ### Endpunkt ``` POST /api/v1/video/task ``` ### Anfrageparameter #### Erforderlich | Parameter | Typ | Beschreibung | |-----------|------|-------------| | `model_name` | string | Muss `"seedance-v2.0-text-to-video"` sein | | `prompt` | string | Prompt zur Videogenerierung | | `duration` | integer | Videodauer in ganzen Sekunden (4-15), in Schritten von 1 | | `resolution` | string | Ausgabeauflösung: `"480p"`, `"720p"`, `"1080p"` oder `"4k"` | | `aspect_ratio` | string | Seitenverhältnis des Videos: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` oder `"3:4"` | #### Optional | Parameter | Typ | Beschreibung | |-----------|------|-------------| | `sound` | boolean | Ob Ton erzeugt wird. Standardwert: `true`; beeinflusst den Preis nicht | ### Beispielanfrage ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'seedance-v2.0-text-to-video', prompt: 'A golden retriever running through a sunlit meadow', duration: 6, resolution: '720p', aspect_ratio: '16:9' }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Seedance 2.0 Bild zu Video ### Anfrageparameter #### Erforderlich | Parameter | Typ | Beschreibung | |-----------|------|-------------| | `model_name` | string | Muss `"seedance-v2.0-image-to-video"` sein | | `prompt` | string | Prompt zur Videogenerierung | | `duration` | integer | Videodauer in ganzen Sekunden (4-15), in Schritten von 1 | | `resolution` | string | Ausgabeauflösung: `"480p"`, `"720p"`, `"1080p"` oder `"4k"` | | `aspect_ratio` | string | Seitenverhältnis des Videos: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` oder `"3:4"` | | `image_url` | string | Erstes Einzelbild des Videos | #### Optional | Parameter | Typ | Beschreibung | |-----------|------|-------------| | `image_end_url` | string | Optionale Bild-URL für das letzte Einzelbild | | `sound` | boolean | Ob Ton erzeugt wird. Standardwert: `true`; beeinflusst den Preis nicht | ### Beispielanfrage ```javascript { model_name: 'seedance-v2.0-image-to-video', image_url: 'https://example.com/image.jpg', image_end_url: 'https://example.com/end-frame.jpg', prompt: 'Camera slowly pulls back to reveal the full landscape', duration: 6, resolution: '720p', aspect_ratio: '16:9' } ``` ## Seedance 2.0 Referenzen zu Video ### Anfrageparameter #### Erforderlich | Parameter | Typ | Beschreibung | |-----------|------|-------------| | `model_name` | string | Muss `"seedance-v2.0-reference-to-video"` sein | | `prompt` | string | Prompt zur Videogenerierung. Schreiben Sie einen normalen Prompt ohne Platzhalter oder verwenden Sie optional die @ (AT)-Referenzfunktion mit `<<>>`, `<<>>` und `<<>>`, um Elemente der jeweiligen Medienarrays ausdrücklich zu referenzieren | | `duration` | integer | Videodauer in ganzen Sekunden (4-15), in Schritten von 1 | | `resolution` | string | Ausgabeauflösung: `"480p"`, `"720p"`, `"1080p"` oder `"4k"` | | `aspect_ratio` | string | Seitenverhältnis des Videos: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` oder `"3:4"` | #### Referenzmedien Übermitteln Sie 1-9 Bilder. Bilder dürfen nur entfallen, wenn mindestens ein Referenzvideo angegeben wird. | Parameter | Typ | Beschreibung | |-----------|------|-------------| | `images` | string[] | 1-9 Referenzbild-URLs oder ein leeres Array, wenn `videos` nicht leer ist | | `videos` | string[] | Bis zu 3 Referenzvideo-URLs; jedes Video muss 2-15 Sekunden lang sein, insgesamt höchstens 15 Sekunden | | `audios` | string[] | Bis zu 3 Referenzaudio-URLs; jeder Audioclip muss 2-15 Sekunden lang sein, insgesamt höchstens 15 Sekunden; WAV oder MP3, höchstens 15 MB pro Clip; mindestens ein Bild oder Video erforderlich | #### @ (AT)-Referenzplatzhalter Die @ (AT)-Referenzfunktion verknüpft Referenzmedien über nummerierte `<<<...>>>`-Platzhalter mit dem Prompt. Die Nummerierung beginnt für jeden Medientyp separat bei `1` und entspricht der Reihenfolge im jeweiligen Array: | Platzhalter | Referenzierter Wert | |-------------|------------------| | `<<>>` | `images[0]` | | `<<>>` | `images[1]` | | `<<>>` | `videos[0]` | | `<<>>` | `audios[0]` | Wenn beispielsweise das erste Bild eine Figur und das zweite eine Szene vorgibt, verwenden Sie in `prompt` `<<>>` für die Figur und `<<>>` für die Szene. Jeder Platzhalter muss auf ein vorhandenes Element des jeweiligen Arrays verweisen. #### Optional | Parameter | Typ | Beschreibung | |-----------|------|-------------| | `sound` | boolean | Ob synchronisierter Ton erzeugt wird. Standardwert: `true` | ### Beispielanfrage ```javascript { model_name: 'seedance-v2.0-reference-to-video', prompt: 'Use image one for the subject, video one for the movement, and audio one for the atmosphere', duration: 8, resolution: '1080p', aspect_ratio: '16:9', sound: true, images: ['https://example.com/subject-reference.jpg'], videos: ['https://example.com/motion-reference.mp4'], audios: ['https://example.com/atmosphere-reference.mp3'] } ``` ### Beispielanfrage für Referenzen zu Video mit @ (AT) ```javascript { model_name: 'seedance-v2.0-reference-to-video', prompt: 'Place the explorer from <<>> in the environment from <<>>, following the camera movement in <<>> and speaking with the reference voice from <<>>', duration: 8, resolution: '1080p', aspect_ratio: '16:9', sound: true, images: [ 'https://example.com/explorer-reference.jpg', 'https://example.com/environment-reference.jpg' ], videos: ['https://example.com/camera-movement-reference.mp4'], audios: ['https://example.com/voice-reference.mp3'] } ``` ## Fast-Varianten Die Fast-Varianten priorisieren die Verarbeitungsgeschwindigkeit. Alle Fast-Modelle unterstützen nur `"480p"` und `"720p"` als Ausgabe. Fast Text zu Video und Fast Bild zu Video verwenden ansonsten dieselbe Anfragestruktur wie die jeweiligen Standardmodelle. Für Fast Referenzen zu Video gelten dieselben Referenzmedienlimits wie für das Standard-Referenzmodell. ### Beispiel einer Fast-Anfrage ```javascript { model_name: 'seedance-v2.0-fast-reference-to-video', prompt: 'Use image one for the subject, follow the movement from video one, and use audio one for the atmosphere', duration: 8, resolution: '720p', aspect_ratio: '9:16', sound: true, images: ['https://example.com/subject-reference.jpg'], videos: ['https://example.com/motion-reference.mp4'], audios: ['https://example.com/atmosphere-reference.mp3'] } ``` ### Beispielanfrage für Fast Referenzen zu Video mit @ (AT) ```javascript { model_name: 'seedance-v2.0-fast-reference-to-video', prompt: 'Have the dancer from <<>> perform the movement from <<>> on the stage in <<>>, using the rhythm from <<>>', duration: 8, resolution: '720p', aspect_ratio: '9:16', sound: true, images: [ 'https://example.com/dancer-reference.jpg', 'https://example.com/stage-reference.jpg' ], videos: ['https://example.com/dance-movement-reference.mp4'], audios: ['https://example.com/rhythm-reference.mp3'] } ``` ### Parameter für Seedance 2.0 Fast Referenzen zu Video #### Erforderlich | Parameter | Typ | Beschreibung | |-----------|------|-------------| | `model_name` | string | Muss `"seedance-v2.0-fast-reference-to-video"` sein | | `prompt` | string | Prompt zur Videogenerierung. Schreiben Sie einen normalen Prompt ohne Platzhalter oder verwenden Sie optional die @ (AT)-Referenzfunktion mit `<<>>`, `<<>>` und `<<>>`, um Elemente der jeweiligen Medienarrays ausdrücklich zu referenzieren | | `duration` | integer | Videodauer in ganzen Sekunden (4-15), in Schritten von 1 | | `resolution` | string | Ausgabeauflösung: `"480p"` oder `"720p"` | | `aspect_ratio` | string | Seitenverhältnis des Videos: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` oder `"3:4"` | #### Referenzmedien | Parameter | Typ | Beschreibung | |-----------|------|-------------| | `images` | string[] | 1-9 Referenzbild-URLs oder ein leeres Array, wenn `videos` nicht leer ist | | `videos` | string[] | Bis zu 3 Referenzvideo-URLs; jedes Video muss 2-15 Sekunden lang sein, insgesamt höchstens 15 Sekunden | | `audios` | string[] | Bis zu 3 Referenzaudio-URLs; jeder Audioclip muss 2-15 Sekunden lang sein, insgesamt höchstens 15 Sekunden; WAV oder MP3, höchstens 15 MB pro Clip; mindestens ein Bild oder Video erforderlich | Die oben beschriebene Platzhalternummerierung ab 1 gilt auch für das Modell Fast Referenzen zu Video. #### Optional | Parameter | Typ | Beschreibung | |-----------|------|-------------| | `sound` | boolean | Ob synchronisierter Ton erzeugt wird. Standardwert: `true` | ## Medienlimits Diese Limits gelten für Anfangs- und Endbilder sowie Referenzmedien der Modelle auf dieser Seite. | Medien | Formate | Limits | |-------|---------|--------| | Bilder | JPEG, PNG, WEBP, BMP, TIFF, GIF, HEIC, HEIF | Jedes Bild muss kleiner als 30 MB sein; Breite und Höhe jeweils 300-6000 px; Verhältnis von Breite zu Höhe 0.4-2.5 | | Videos | MP4, MOV | Jeweils höchstens 200 MB; Breite und Höhe jeweils 300-6000 px; Verhältnis von Breite zu Höhe 0.4-2.5; Bildrate 24-60 FPS | | Audio | WAV, MP3 | Jeweils höchstens 15 MB | | Anfragekörper | — | Höchstens 64 MB | Für Referenzaudio und Referenzvideos gilt jeweils separat eine Gesamtdauer von höchstens 15 Sekunden. Die Anzahlen sind unabhängig: bis zu 9 Bilder, 3 Videos und 3 Audioclips. Zusätzliche Videos verringern die zulässige Bildanzahl nicht. Alle Modelle verwenden standardmäßig `720p`, doch `resolution` muss weiterhin angegeben werden. Der Tonschalter ist standardmäßig `true`; weder dieser Schalter noch Referenzaudio ändern den Preis. Referenzen zu Video erfordert mindestens ein Bild oder Video; reine Audioanfragen werden nicht unterstützt. Das Hochladen von Referenzvideos verdoppelt die Generierungskosten unabhängig von Anzahl oder Dauer. ## Antwortformat ### Erste Antwort Alle Modelle geben eine `task_id` für die regelmäßige Abfrage zurück: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "submitted" } } ``` ### Abfrageantwort Fragen Sie `GET /api/v1/video/{taskId}` ab, um den Status zu prüfen: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "succeed", "task_status_msg": null, "task_result": { "credit": 0.2, "videos": [ { "url": "https://example.com/generated-video.mp4" } ] } } } ``` ### Statuswerte - `submitted`: Aufgabe angenommen und wartet auf Verarbeitung - `processing`: Videogenerierung läuft - `succeed`: Videogenerierung abgeschlossen - `failed`: Videogenerierung fehlgeschlagen ## Verarbeitungszeit **Standardmodelle**: 3-8 Minuten je nach Dauer und Auflösung. **Fast-Modelle**: 1-4 Minuten bei den meisten Konfigurationen. Prüfen Sie den Status alle 5-10 Sekunden. ## Empfohlene Vorgehensweisen 1. **Passende Variante wählen**: Fast-Modelle für Iterationen, Standardmodelle für die endgültige Ausgabe verwenden 2. **Bewegungen klar beschreiben**: konkrete Bewegungsbeschreibungen in Prompts aufnehmen 3. **Auflösung wählen**: alle Standardmodelle von Seedance 2.0 unterstützen `480p`, `720p`, `1080p` und `4k`; alle Fast-Modelle nur `480p` und `720p` 4. **Referenzen ordnen**: `images`, `videos` und `audios` gezielt anordnen und im Prompt konsistent referenzieren 5. **Reine Videoanfragen**: ein leeres `images`-Array nur verwenden, wenn mindestens ein Referenzvideo angegeben wird 6. **Mediendauer**: jede Referenzaudio- und Videodatei auf 2 bis 15 Sekunden begrenzen 7. **Ton nutzen**: `sound` weglassen, um den Standardwert `true` zu verwenden, oder auf `false` setzen, um die Tonerzeugung zu deaktivieren