# Seedance 2.5 Flash API Vollständige API-Referenz für die Seedance 2.5 Flash-Modelle von ByteDance zur Videogenerierung. ## Modellvarianten Diese API unterstützt drei Modellvarianten: | Modell | ID | Beschreibung | |-------|----|-------------| | **Seedance 2.5 Flash Text to Video** | `seedance-v2.5-flash-text-to-video` | Generierung hochwertiger Videos aus Text | | **Seedance 2.5 Flash Image to Video** | `seedance-v2.5-flash-image-to-video` | Videogenerierung mit vorgegebenem Startbild oder mit Start- und Endbild | | **Seedance 2.5 Flash Reference to Video** | `seedance-v2.5-flash-reference-to-video` | Videogenerierung anhand von Referenzbildern, Referenzvideos und Audioreferenzen | ## Kurzvergleich | Merkmal | Text zu Video | Bild zu Video | Referenz zu Video | |---------|---------------|----------------|--------------------| | Dauer | 4–30 Sekunden | 4–30 Sekunden | 4–30 Sekunden | | Verfügbare Auflösungen | 480p, 720p | 480p, 720p | 480p, 720p | | Seitenverhältnis | Optional (Standard: 16:9) | Nicht unterstützt | Optional (Standard: 16:9) | | Erforderliche Medien | Keine | Startbild | Keine | | Optionale Medien | Keine | Endbild | Bilder, Videos und Audiodateien | ### Unterstützte Seitenverhältnisse Die Varianten für die Videogenerierung aus Text und aus Referenzen unterstützen folgende Seitenverhältnisse: `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` Die Variante für die Videogenerierung aus einem Bild unterstützt den Parameter `aspect_ratio` nicht. ### Verfügbare Auflösungen | Auflösung | Beschreibung | |------------|-------------| | `480p` | Standardauflösung | | `720p` | Hohe Auflösung | ## Seedance 2.5 Flash Text to Video ### Endpunkt ``` POST /api/v1/video/task ``` ### Anfrageparameter #### Pflichtparameter | Parameter | Typ | Beschreibung | |-----------|------|-------------| | `model_name` | string | Muss `"seedance-v2.5-flash-text-to-video"` sein | | `prompt` | string | Prompt für die Videogenerierung mit bis zu 5000 Zeichen | | `resolution` | string | Ausgabeauflösung: `"480p"` oder `"720p"`. Kein Standardwert | | `duration` | integer | Videodauer in ganzen Sekunden von 4 bis 30 in Einerschritten. Kein Standardwert | #### Optionale Parameter | Parameter | Typ | Beschreibung | |-----------|------|-------------| | `aspect_ratio` | string | Seitenverhältnis des Videos: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` oder `"3:4"`. Standardwert: `"16:9"` | | `sound` | boolean | Gibt an, ob Ton erzeugt werden soll. Der Standardwert ist `true`. Mit `false` wird ein Video ohne Ton erzeugt | ### 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.5-flash-text-to-video', prompt: 'A golden retriever running through a sunlit meadow', resolution: '720p', duration: 8, aspect_ratio: '16:9', sound: true }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Seedance 2.5 Flash Image to Video ### Anfrageparameter #### Pflichtparameter | Parameter | Typ | Beschreibung | |-----------|------|-------------| | `model_name` | string | Muss `"seedance-v2.5-flash-image-to-video"` sein | | `prompt` | string | Prompt für die Videogenerierung mit bis zu 5000 Zeichen | | `resolution` | string | Ausgabeauflösung: `"480p"` oder `"720p"`. Kein Standardwert | | `duration` | integer | Videodauer in ganzen Sekunden von 4 bis 30 in Einerschritten. Kein Standardwert | | `image_url` | string | URL des Startbilds. Das Ausgabevideo übernimmt das Seitenverhältnis dieses Bilds. Siehe „Medienbeschränkungen“ weiter unten | #### Optionale Parameter | Parameter | Typ | Beschreibung | |-----------|------|-------------| | `image_end_url` | string | Optionale URL des Endbilds. Empfohlen wird dasselbe Seitenverhältnis wie beim Startbild. Siehe „Medienbeschränkungen“ weiter unten | | `sound` | boolean | Gibt an, ob Ton erzeugt werden soll. Der Standardwert ist `true`. Mit `false` wird ein Video ohne Ton erzeugt | > Geben Sie `aspect_ratio` bei Anfragen zur Videogenerierung aus einem Bild nicht an. Dieses Modell unterstützt den Parameter nicht. ### Beispielanfrage ```javascript { model_name: 'seedance-v2.5-flash-image-to-video', image_url: 'https://example.com/first-frame.jpg', image_end_url: 'https://example.com/last-frame.jpg', prompt: 'Camera slowly pulls back to reveal the full landscape', resolution: '720p', duration: 8, sound: true } ``` ## Seedance 2.5 Flash Reference to Video ### Anfrageparameter #### Pflichtparameter | Parameter | Typ | Beschreibung | |-----------|------|-------------| | `model_name` | string | Muss `"seedance-v2.5-flash-reference-to-video"` sein | | `prompt` | string | Prompt für die Videogenerierung mit bis zu 5000 Zeichen. Schreiben Sie einen normalen Prompt ohne Platzhalter oder verwenden Sie die Referenzfunktion @ (AT) mit `<<>>`, `<<>>` und `<<>>`, um gezielt auf Elemente in den jeweiligen Medienarrays zu verweisen | | `resolution` | string | Ausgabeauflösung: `"480p"` oder `"720p"`. Kein Standardwert | | `duration` | integer | Videodauer in ganzen Sekunden von 4 bis 30 in Einerschritten. Kein Standardwert | #### Referenzmedien Alle Referenzmedien sind optional. Anfragen können ausschließlich Bilder, Videos oder Audiodateien enthalten oder ganz auf Referenzmedien verzichten. Für die Generierung ohne Referenzen wird die Variante Text to Video empfohlen. | Parameter | Typ | Beschreibung | |-----------|------|-------------| | `images` | string[] | 0–10 URLs von Referenzbildern. Die Referenzierung folgt der Reihenfolge im Array. Siehe „Medienbeschränkungen“ weiter unten | | `videos` | string[] | 0–5 URLs von Referenzvideos im MP4- oder MOV-Format. Jedes Video muss 2–30 Sekunden lang sein. Die Gesamtdauer darf 30 Sekunden nicht überschreiten. Siehe „Medienbeschränkungen“ weiter unten. Für die Abrechnung wird die Gesamtdauer der Referenzvideos auf die nächste volle Sekunde gerundet (halbe Sekunden werden aufgerundet) und anschließend zur Dauer des Ausgabevideos addiert | | `audios` | string[] | 0–5 URLs von Audioreferenzen im WAV- oder MP3-Format. Jede Datei muss 2–30 Sekunden lang sein und darf höchstens 15 MB groß sein. Die Gesamtdauer darf 30 Sekunden nicht überschreiten | #### Referenzplatzhalter für @ (AT) Die Referenzfunktion @ (AT) verknüpft die Referenzmedien über nummerierte Platzhalter der Form `<<<...>>>` mit dem Prompt. Die Nummerierung beginnt für jeden Medientyp bei `1` und folgt 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 im entsprechenden Array verweisen. #### Optionale Parameter | Parameter | Typ | Beschreibung | |-----------|------|-------------| | `aspect_ratio` | string | Seitenverhältnis des Videos: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` oder `"3:4"`. Standardwert: `"16:9"` | | `sound` | boolean | Gibt an, ob Ton erzeugt werden soll. Der Standardwert ist `true`. Mit `false` wird ein Video ohne Ton erzeugt | ### Beispielanfrage ```javascript { model_name: 'seedance-v2.5-flash-reference-to-video', prompt: 'Use image one for the subject, video one for the movement, and audio one for the atmosphere', resolution: '720p', duration: 8, 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 die Videogenerierung mit @-Referenzen (AT) ```javascript { model_name: 'seedance-v2.5-flash-reference-to-video', prompt: 'Place the explorer from <<>> in the environment from <<>>, following the camera movement in <<>> and speaking with the reference voice from <<>>', resolution: '720p', duration: 10, aspect_ratio: '16:9', sound: true, images: [ 'https://example.com/explorer-reference.jpg', 'https://example.com/environment-reference.png' ], videos: ['https://example.com/camera-movement-reference.mp4'], audios: ['https://example.com/voice-reference.mp3'] } ``` ## Medienbeschränkungen Diese Beschränkungen gelten für Startbilder, Endbilder und Referenzmedien der auf dieser Seite beschriebenen Modelle. | Medium | Formate | Beschränkungen | |-------|---------|--------| | Bilder | JPEG, PNG, WEBP, BMP, TIFF, GIF, HEIC, HEIF | Jedes Bild muss kleiner als 30 MB sein. Breite und Höhe müssen jeweils 300–6000 px betragen, das Verhältnis von Breite zu Höhe muss zwischen 0,4 und 2,5 liegen | | Videos | MP4, MOV | Höchstens 200 MB pro Video. Breite und Höhe müssen jeweils 300–6000 px betragen, das Verhältnis von Breite zu Höhe muss zwischen 0,4 und 2,5 liegen. Erforderlich sind 24–60 Bilder pro Sekunde und eine Gesamtpixelzahl von 407696–8295044 | | Audio | WAV, MP3 | Höchstens 15 MB pro Datei | Für Audioreferenzen und Referenzvideos gilt jeweils eine eigene Höchstgrenze von insgesamt 30 Sekunden. Auch die Mengenbegrenzungen gelten unabhängig voneinander: bis zu 10 Bilder, 5 Videos und 5 Audioclips. Alle Modelle erfordern `resolution` und `duration`. Für beide gibt es keinen Standardwert. Bei der Generierung aus Text und aus Referenzen gilt `16:9`, wenn `aspect_ratio` fehlt. Die Tonausgabe ist standardmäßig aktiviert (`true`). Für ein Video ohne Ton setzen Sie den Wert auf `false`. ## Antwortformat ### Erste Antwort Alle Modelle geben eine `task_id` für die Statusabfrage 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" } } ``` ### Antwort auf die Statusabfrage Fragen Sie den Status über `GET /api/v1/video/{taskId}` ab: ```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`: Auftrag angenommen und wartet auf die Verarbeitung - `processing`: Videogenerierung läuft - `succeed`: Videogenerierung abgeschlossen - `failed`: Videogenerierung fehlgeschlagen ## Verarbeitungszeit Die Verarbeitungszeit hängt von der Videodauer, der Auflösung und der aktuellen Auslastung der Warteschlange ab. Fragen Sie den Status alle 5–10 Sekunden ab. ## Empfohlene Vorgehensweise 1. **Pflichtparameter**: Geben Sie immer `prompt`, `resolution` und `duration` an. Für die Generierung aus Text und aus Referenzen ist `aspect_ratio` optional. Der Standardwert ist `16:9` 2. **Seitenverhältnis bei der Generierung aus einem Bild**: Senden Sie bei diesen Anfragen kein `aspect_ratio` 3. **Referenzvideos**: Videos sind optional. Sowohl die Dauer jedes einzelnen Videos als auch die Gesamtdauer müssen innerhalb der angegebenen Grenzen liegen 4. **Referenzbilder**: Bilder sind unabhängig von Videos und Audio optional. Geben Sie bis zu 10 URLs von Bildern in unterstützten Formaten an 5. **Audioreferenzen**: Jeder Audioclip muss 2–30 Sekunden lang sein und darf höchstens 15 MB groß sein. Die Gesamtdauer darf 30 Sekunden nicht überschreiten 6. **Reihenfolge der Referenzen**: Ordnen Sie `images`, `videos` und `audios` in der gewünschten Reihenfolge an und beachten Sie diese bei Verweisen im Prompt 7. **Ton**: Lassen Sie `sound` weg, um den Standardwert `true` zu verwenden, oder setzen Sie den Parameter auf `false`, um die Tonausgabe zu deaktivieren