Seedance 2.0 API
Vollständige API-Referenz für die Seedance 2.0-Videogenerierungsmodelle von ByteDance.
Modellvarianten
Diese API unterstützt sechs Modellvarianten:
Kurzvergleich
Unterstützte Seitenverhältnisse
21:9, 16:9, 9:16, 1:1, 4:3, 3:4
Auflösungsoptionen
Seedance 2.0 Text zu Video
Endpunkt
POST /api/v1/video/task
Anfrageparameter
Erforderlich
Optional
Beispielanfrage
javascript
Seedance 2.0 Bild zu Video
Anfrageparameter
Erforderlich
Optional
Beispielanfrage
javascript
Seedance 2.0 Referenzen zu Video
Anfrageparameter
Erforderlich
Referenzmedien
Übermitteln Sie 1-9 Bilder. Bilder dürfen nur entfallen, wenn mindestens ein Referenzvideo angegeben wird.
@ (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:
Wenn beispielsweise das erste Bild eine Figur und das zweite eine Szene vorgibt, verwenden Sie in prompt <<<image_1>>> für die Figur und <<<image_2>>> für die Szene. Jeder Platzhalter muss auf ein vorhandenes Element des jeweiligen Arrays verweisen.
Optional
Beispielanfrage
javascript
Beispielanfrage für Referenzen zu Video mit @ (AT)
javascript
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
Beispielanfrage für Fast Referenzen zu Video mit @ (AT)
javascript
Parameter für Seedance 2.0 Fast Referenzen zu Video
Erforderlich
Referenzmedien
Die oben beschriebene Platzhalternummerierung ab 1 gilt auch für das Modell Fast Referenzen zu Video.
Optional
Medienlimits
Diese Limits gelten für Anfangs- und Endbilder sowie Referenzmedien der Modelle auf dieser Seite.
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
Abfrageantwort
Fragen Sie GET /api/v1/video/{taskId} ab, um den Status zu prüfen:
json
Statuswerte
submitted: Aufgabe angenommen und wartet auf Verarbeitungprocessing: Videogenerierung läuftsucceed: Videogenerierung abgeschlossenfailed: 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
- Passende Variante wählen: Fast-Modelle für Iterationen, Standardmodelle für die endgültige Ausgabe verwenden
- Bewegungen klar beschreiben: konkrete Bewegungsbeschreibungen in Prompts aufnehmen
- Auflösung wählen: alle Standardmodelle von Seedance 2.0 unterstützen
480p,720p,1080pund4k; alle Fast-Modelle nur480pund720p - Referenzen ordnen:
images,videosundaudiosgezielt anordnen und im Prompt konsistent referenzieren - Reine Videoanfragen: ein leeres
images-Array nur verwenden, wenn mindestens ein Referenzvideo angegeben wird - Mediendauer: jede Referenzaudio- und Videodatei auf 2 bis 15 Sekunden begrenzen
- Ton nutzen:
soundweglassen, um den Standardwerttruezu verwenden, oder auffalsesetzen, um die Tonerzeugung zu deaktivieren