Seedance Videogenerierung
Generiere KI-Tanz- und Bewegungsvideos über die Seedance-API (ByteDance) von AceDataCloud.
Einrichtung: Siehe Authentifizierung für die Token-Einrichtung.
Kurzstart
curl -X POST https://api.acedata.cloud/seedance/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"model": "doubao-seedance-2-0-260128", "content": [{"type": "text", "text": "a dancer performing contemporary ballet in a misty forest"}], "callback_url": "https://api.acedata.cloud/health"}'
Asynchron: Siehe asynchrone Task-Abfrage. Frage über
POST /seedance/tasksmit{"id": "..."}ab. Dies gibt sofort eine Task-ID zurück. Frage das Ergebnis ab:
curl -X POST https://api.acedata.cloud/seedance/tasks \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"id": "<task_id von oben>"}'
Modelle
Seedance 2.0 (aktuelle Generation – multimodale Referenz)
Die 2.0-Serie fügt multimodale Referenzeingaben hinzu: echte Personen-/Charakter-Bild-Referenzen, Referenz-Audio und Referenz-Video (siehe die Workflows unten).
| Modell | Am besten geeignet für | Max. Auflösung |
|---|---|---|
doubao-seedance-2-0-260128 | Höchste Qualität, echte Personen-/Charakter-Referenz, 4k-Ausgabe | 4k |
doubao-seedance-2-0-fast-260128 | Schnellere 2.0 Generierung | 720p |
doubao-seedance-2-0-mini-260615 | Leichtgewichtig / kostengünstigste 2.0 | 720p |
Seedance 1.x
| Modell | Typ | Am besten geeignet für |
|---|---|---|
doubao-seedance-1-5-pro-251215 | Text+Bild-zu-Video | 1.5 Flaggschiff, Audio-Unterstützung |
doubao-seedance-1-0-pro-250528 | Text+Bild-zu-Video | Allgemeiner Zweck, zuverlässige Qualität |
doubao-seedance-1-0-pro-fast-251015 | Text+Bild-zu-Video | Schnellere Pro-Generierung |
doubao-seedance-1-0-lite-t2v-250428 | Nur Text-zu-Video | Leichtgewichtige Text-zu-Video |
doubao-seedance-1-0-lite-i2v-250428 | Nur Bild-zu-Video | Leichtgewichtige Bild-zu-Video |
Workflows
1. Text-zu-Video
Übergebe ein Text-Inhaltselement im content-Array.
POST /seedance/videos
{
"model": "doubao-seedance-1-0-pro-250528",
"content": [
{"type": "text", "text": "a street dancer doing breakdancing moves in an urban setting"}
],
"resolution": "1080p",
"ratio": "16:9",
"duration": 5
}
2. Bild-zu-Video
Füge ein Bild-Inhaltselement (mit optionaler role) zusammen mit dem Text hinzu.
POST /seedance/videos
{
"model": "doubao-seedance-1-5-pro-251215",
"content": [
{"type": "text", "text": "the person starts dancing gracefully"},
{
"type": "image_url",
"role": "first_frame",
"image_url": {"url": "https://example.com/dancer.jpg"}
}
],
"resolution": "720p",
"duration": 5
}
Bild-Rollen:
first_frame– Bild wird als erstes Bild verwendetlast_frame– Bild wird als letztes Bild verwendetreference_image– Bild wird als Stil-/Subjekt-/echte Personen-Referenz verwendet (Seedance 2.0 behält die referenzierte Person oder den Charakter konsistent)
Referenzmedien (nur Seedance 2.0):
audio_url– Referenzaudio für Stimmfarbe / Hintergrundmusik (keinerole)video_url– Referenzvideo für Subjekt, Kamerabewegung, Bewegung oder Gesamtstil (keinerole)
3. Erstes + Letztes Bild
Bereitstellen sowohl eines Start- als auch eines Endbildes:
POST /seedance/videos
{
"model": "doubao-seedance-2-0-260128",
"content": [
{"type": "text", "text": "smooth transition between two scenes"},
{"type": "image_url", "role": "first_frame", "image_url": {"url": "https://example.com/start.jpg"}},
{"type": "image_url", "role": "last_frame", "image_url": {"url": "https://example.com/end.jpg"}}
]
}
4. Echte Personen-/Charakter-Referenz (Seedance 2.0)
Seedance 2.0 Modelle (doubao-seedance-2-0-260128, doubao-seedance-2-0-fast-260128, doubao-seedance-2-0-mini-260615) können eine bestimmte Person oder einen Charakter in einer völlig neuen Szene konsistent halten. Übergebe ein oder mehrere Fotos als image_url-Elemente mit role: "reference_image" – das Modell bewahrt das Aussehen dieses Subjekts. Es werden bis zu 9 Referenzbilder akzeptiert.
POST /seedance/videos
{
"model": "doubao-seedance-2-0-260128",
"content": [
{"type": "text", "text": "the same person walking through a neon-lit night market, cinematic"},
{"type": "image_url", "role": "reference_image", "image_url": {"url": "https://example.com/person.jpg"}}
],
"resolution": "1080p",
"duration": 8
}
5. Referenzaudio / -video (Seedance 2.0)
2.0 Modelle akzeptieren auch Referenz-Audio (Stimmfarbe, Hintergrundmusik) und Referenz-Video (Subjektinhalt, Kamerabewegung, Bewegung, Gesamtstil). Füge audio_url- und/oder video_url-Inhaltselemente hinzu. Limit: bis zu 3 Audio- und 3 Video-Referenzen pro Anfrage.
POST /seedance/videos
{
"model": "doubao-seedance-2-0-260128",
"content": [
{"type": "text", "text": "a singer performing on stage, matching the reference voice and motion"},
{"type": "image_url", "role": "reference_image", "image_url": {"url": "https://example.com/person.jpg"}},
{"type": "audio_url", "audio_url": {"url": "https://example.com/voice.mp3"}},
{"type": "video_url", "video_url": {"url": "https://example.com/motion.mp4"}}
],
"generate_audio": true
}
Parameter
| Parameter | Werte | Beschreibung |
|---|---|---|
model | siehe Tabelle Modelle | Zu verwendendes Modell (erforderlich) |
content | Array | Eingabeelemente: text, image_url, audio_url (2.0), video_url (2.0) (erforderlich) |
resolution | "480p", "720p", "1080p", "4k" | Ausgabeauflösung. 4k ist nur für doubao-seedance-2-0-260128 (Standard); 2-0-fast / 2-0-mini maximal 720p (Standard: 720p für pro/2.0, 480p für lite) |
ratio | "16:9", "4:3", "1:1", "3:4", "9:16", "21:9", "adaptive" | Seitenverhältnis (Standard: 16:9) |
duration | 2 – 15 | Dauer in Sekunden (Seedance 2.0 unterstützt 4–15) |
frames | 29–361 (muss 25+4n erfüllen) | Bildanzahl – schließt sich mit duration gegenseitig aus |
seed | -1 bis 4294967295 | Seed für reproduzierbare Ergebnisse (-1 = zufällig) |
generate_audio | true / false | Audio generieren (unterstützt von doubao-seedance-1-5-pro-251215 und der doubao-seedance-2-0-Serie; andere Modelle ignorieren es) |
camerafixed | true / false | Kameraposition während der Generierung fixieren |
watermark | true / false | Wasserzeichen zum generierten Video hinzufügen |
return_last_frame | true / false | Letztes Bild des generierten Videos zurückgeben |
service_tier | "default", "flex" | Verarbeitungsstufe (Standard: default) |
execution_expires_after | number | Zeitüberschreitungsschwelle für Tasks in Sekunden |
Inline-Parameter-Syntax
Du kannst Generierungsparameter auch direkt im Text-Prompt mit der --param value-Syntax einbetten:
A kitten yawning at the camera. --rs 720p --rt 16:9 --dur 5 --fps 24 --seed 42
Unterstützte Inline-Parameter: --rs (Auflösung), --rt (Seitenverhältnis), --dur (Dauer), --frames, --fps (nur 24), --seed, --cf (camera_fixed), --wm (Wasserzeichen).
Fallstricke
- Modellnamen verwenden die
doubao-*-Konvention (z.B.doubao-seedance-1-0-pro-250528) – alte Kurznamen wieseedance-1.0sind ungültig - Das
content-Array ersetzt die altenprompt+image_url-Felder; verwende immercontent - Bild- und Textszenarien schließen sich pro Inhaltselement gegenseitig aus – jedes Element hat entweder
textoderimage_url, nicht beides first_frameundlast_framekönnen in einer Anfrage kombiniert werden, aberreference_imageschließt sich mitfirst_frame/last_framegegenseitig aus – verwende kein Referenzbild zusammen mit ersten/letzten Bilderngenerate_audio: truewird vondoubao-seedance-1-5-pro-251215und derdoubao-seedance-2-0-Serie unterstützt; andere Modelle ignorieren dieses Feld- Lite-Modelle sind aufgeteilt:
*-lite-t2v-*akzeptiert nur Text,*-lite-i2v-*akzeptiert nur Bild-zu-Video audio_url- undvideo_url-Referenzelemente werden nur von der Seedance 2.0 Serie verwendet- Auflösungsoptionen sind
480p,720p,1080pund4k(4kist nur fürdoubao-seedance-2-0-260128;2-0-fast/2-0-minimaximal720p) – es gibt keine 360p oder 540p service_tier-Werte sind"default"und"flex"(nicht "standard"/"premium")- Der Dauerbereich beträgt 2–15 Sekunden (Seedance 2.0 unterstützt 4–15) – Werte außerhalb dieses Bereichs schlagen fehl
- Task-Status verwenden
"succeeded"(nicht "completed") – überprüfe diesen Wert beim Abfragen
MCP:
pip install mcp-seedance| Gehostet:https://seedance.mcp.acedata.cloud/mcp| Siehe alle MCP-Server