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:
Kurzvergleich
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
Seedance 2.5 Flash Text to Video
Endpunkt
POST /api/v1/video/task
Anfrageparameter
Pflichtparameter
Optionale Parameter
Beispielanfrage
javascript
Seedance 2.5 Flash Image to Video
Anfrageparameter
Pflichtparameter
Optionale Parameter
Geben Sie
aspect_ratiobei Anfragen zur Videogenerierung aus einem Bild nicht an. Dieses Modell unterstützt den Parameter nicht.
Beispielanfrage
javascript
Seedance 2.5 Flash Reference to Video
Anfrageparameter
Pflichtparameter
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.
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:
Wenn beispielsweise das erste Bild eine Figur und das zweite eine Szene vorgibt, verwenden Sie in prompt für die Figur <<<image_1>>> und für die Szene <<<image_2>>>. Jeder Platzhalter muss auf ein vorhandenes Element im entsprechenden Array verweisen.
Optionale Parameter
Beispielanfrage
javascript
Beispielanfrage für die Videogenerierung mit @-Referenzen (AT)
javascript
Medienbeschränkungen
Diese Beschränkungen gelten für Startbilder, Endbilder und Referenzmedien der auf dieser Seite beschriebenen Modelle.
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
Antwort auf die Statusabfrage
Fragen Sie den Status über GET /api/v1/video/{taskId} ab:
json
Statuswerte
submitted: Auftrag angenommen und wartet auf die Verarbeitungprocessing: Videogenerierung läuftsucceed: Videogenerierung abgeschlossenfailed: 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
- Pflichtparameter: Geben Sie immer
prompt,resolutionunddurationan. Für die Generierung aus Text und aus Referenzen istaspect_ratiooptional. Der Standardwert ist16:9 - Seitenverhältnis bei der Generierung aus einem Bild: Senden Sie bei diesen Anfragen kein
aspect_ratio - Referenzvideos: Videos sind optional. Sowohl die Dauer jedes einzelnen Videos als auch die Gesamtdauer müssen innerhalb der angegebenen Grenzen liegen
- Referenzbilder: Bilder sind unabhängig von Videos und Audio optional. Geben Sie bis zu 10 URLs von Bildern in unterstützten Formaten an
- Audioreferenzen: Jeder Audioclip muss 2–30 Sekunden lang sein und darf höchstens 15 MB groß sein. Die Gesamtdauer darf 30 Sekunden nicht überschreiten
- Reihenfolge der Referenzen: Ordnen Sie
images,videosundaudiosin der gewünschten Reihenfolge an und beachten Sie diese bei Verweisen im Prompt - Ton: Lassen Sie
soundweg, um den Standardwerttruezu verwenden, oder setzen Sie den Parameter auffalse, um die Tonausgabe zu deaktivieren