Skip to main content
Seedance ist eine Flaggschiff-Familie multimodaler Videomodelle auf Venice für text-, bild- und referenzgetriebene Videogenerierung. Seedance 2.0 (samt Fast) und Seedance 2.5 teilen sich dasselbe R2V-Prompt-Routing-Modell: ein einzelner Reference-to-Video-Endpunkt verarbeitet vier verschiedene Workflows (Reference, Edit, Extend, Stitch) – der Workflow wird aus der Form Ihres Prompts abgeleitet. Dieser Leitfaden behandelt Varianten, die vier Workflows, die Medienrichtlinie der öffentlichen API, familienspezifische multimodale Limits, Preise und curl-Beispiele.
Medien mit erkennbaren Personen werden von der öffentlichen Seedance-API nicht unterstützt. Solche Eingaben können vom Anbieter als Content-Policy- bzw. Provider-Fehler abgelehnt werden. Für den vollen Seedance-Funktionsumfang verwenden Sie die Venice-App oder Studio.

Varianten

Alle Varianten sind asynchron. Übermitteln Sie über POST /api/v1/video/queue und pollen Sie anschließend POST /api/v1/video/retrieve, bis der Response-Body den Typ video/mp4 hat. Siehe Video Generation für den allgemeinen Queue-Ablauf. Übergeben Sie resolution als einen der Werte: 480p, 720p, 1080p oder 4k (in Kleinbuchstaben). Seedance 2.0 (Nicht-Fast) akzeptiert alle vier; 2.0 Fast und 2.5 akzeptieren nur 480p / 720p. Ermitteln Sie aktuelle Model-IDs und Fähigkeiten über GET /models?type=video – kodieren Sie die Verfügbarkeit nicht fest.

Das Modell “Ein Modell, vier Workflows”

Die Reference-to-Video-Varianten (seedance-2-0-reference-to-video-basic, das Fast-Pendant und seedance-2-5-reference-to-video-basic) verwenden dasselbe Prompt-Routing-Muster. Das Modell leitet die Aufgabe aus dem Prompt-Präfix und der Form Ihrer Eingaben ab. Es gibt kein Feld task oder workflow – die Prompt-Syntax ist das Routing. Die Prompt-Syntax ist kanonisch und Groß-/Kleinschreibung-sensitiv: spitze Klammern, großer Anfangsbuchstabe, ein Leerzeichen vor der Nummer – <Video 1>, <Image 1>, <Audio 1>.

Workflow-Muster

Reference-Workflow

Verwenden Sie die hochgeladenen Referenzdateien als Donors – Motiv, Szene, Bewegung, Stil, Stimmklang –, um ein völlig neues Video zu erzeugen. Kanonische Prompt-Muster:
Beispiele:
  • Refer to <Subject 1> in <Image 1> to generate a 5-second clip of the same character riding a horse through snow.
  • Refer to the camera scene in <Video 1> to generate a similar establishing shot of a futuristic city at dawn.
  • Refer to <Subject 1> in <Image 1> and use the timbre in <Audio 1> for the narrator describing the scene. (Audio-Donors müssen mit mindestens einer Bild- oder Video-Referenz kombiniert werden – reines Audio wird abgelehnt)

Edit-Workflow

Modifiziert ein einzelnes Eingabevideo. Alles, was nicht ausdrücklich im Prompt genannt wird, bleibt erhalten. Verwenden Sie diesen Workflow, wenn Sie eine lokale Änderung (Motiv-Austausch, Wetter-/Farbwechsel, Hinzufügen/Entfernen von Elementen) statt eines völlig neuen Videos wünschen. Kanonisches Prompt-Muster:
Untermuster für feinere Kontrolle:
Beispiele:
  • Strictly edit <Video 1>, changing its weather from sunny to a heavy rainstorm.
  • Add snacks such as fried chicken and pizza to the countertop in <Video 1>.
  • Remove the red car from <Video 1>, keeping the rest of the video content unchanged.
  • Replace the perfume featured in <Video 1> with the face cream from <Image 1>, with all original motions and camera work preserved.
Das letzte Beispiel kombiniert Edit mit einer Bildreferenz – völlig zulässig, das Modell verwendet <Image 1> als visuellen Donor für die Ersetzung.

Quellabgeglichenes Seitenverhältnis und Dauer

Für Seedance Reference-to-Video Edit / Extend können Sie die Ausgabe an den Quellclip anlehnen, statt ein festes Verhältnis oder eine feste Länge zu wählen: Voraussetzungen:
  • Queue: Jeder quellabgeglichene Wert erfordert reference_video_urls.
  • Quote: Jeder quellabgeglichene Wert erfordert reference_video_total_duration. Quellabgeglichene Dauer wird mit ceil(reference_video_total_duration) Sekunden abgerechnet.
  • Seitenverhältnis und Dauer sind unabhängig – Sie können eines abgleichen, ohne das andere abzugleichen.
  • Für Extend bevorzugen Sie eine feste duration (wie lange generiert werden soll) und optional aspect_ratio: "adaptive". Quellabgeglichene duration ist für Edit-typische „gleiche Länge wie Quelle”-Jobs gedacht.

Extend-Workflow

Setzen Sie einen einzelnen Clip zeitlich vorwärts oder rückwärts fort. Standardmäßig gibt Seedance nur den neuen Inhalt zurück – nicht den ursprünglichen Input verkettet mit der Erweiterung. Das ist Absicht und dient der Übergangskontinuität; wenn Sie möchten, dass der Eingabeclip zusammen mit der Erweiterung erhalten bleibt, geben Sie das ausdrücklich an:
Übergangsbehandlung: Das Modell extrahiert automatisch die Übergangsframes für nahtloses Blending, und die ursprünglichen Segmente des Eingabevideos werden nicht neu generiert. Beispiele:
  • Extend <Video 1>, generate a dramatic chase scene through narrow alleys at dusk.
  • Extend <Video 1> backward, the same character walking toward the camera before the original shot begins.
  • Extend <Video 1>, start with <Video 1>, then the camera pulls back to reveal a vast landscape.

Stitch-Workflow (Track Completion)

Verbindet Eingabeclips mit KI-generierten Übergängen. Beachten Sie die familienspezifischen Obergrenzen für kombinierte Dauer und Clip-Anzahl in Multimodale Eingabelimits (Seedance 2.0: ≤3 Clips / ≤15 s kombiniert; Seedance 2.5: höhere Video-Obergrenzen). Kanonisches Prompt-Muster:
Beispiele:
  • <Video 1> + a smooth seamless cut + followed by <Video 2>
  • <Video 1>. The moment a leaf falls to the ground, it sets off a special effect of golden particles. A gust of wind blows by, leading into <Video 2>.
  • <Video 1> + a wisp of smoke transforms into a flock of birds + followed by <Video 2> + a slow dolly-in + followed by <Video 3>
Das Modell trimmt Verbindungssegmente an den Schnittstellen automatisch für Kontinuität.

Universelle Prompt-Formel

Über alle vier Workflows hinweg lautet die empfohlene Autorenformel:
  • Subject + Motion: die logische Grundlage – definiert “Wer” welche “Aktion” ausführt
  • Environment + Aesthetics: räumlicher Hintergrund, Beleuchtung, visueller Stil
  • Camera: expliziter Aufnahmetyp oder Bewegung
  • Audio: Umgebungsklänge oder Stimmvorgabe für immersive Ausgabe
Wenn Sie dies auf ein Workflow-Präfix aufsetzen (z. B. Strictly edit <Video 1>, changing its <subject + motion + environment + ...>), erhalten Sie Ergebnisse höchster Qualität.

Multimodale Eingabelimits

Die untenstehenden Werte sind das, was die Venice API akzeptiert. Anfragen außerhalb dieser Bereiche werden auf Schema-Ebene mit einem 400-Fehler abgelehnt, noch bevor Inferenz stattfindet. Seedance 2.0 und Seedance 2.5 verwenden unterschiedliche Obergrenzen. Prüfen Sie immer die Spalte für die Modellfamilie, die Sie aufrufen.

Gemeinsame Medien-Mindestwerte

Familienvergleich

Referenzaudio wird nur bei den R2V-Varianten unterstützt. Jeder Eintrag wird an das Modell als role: "reference_audio"-Content-Item weitergeleitet, das der Prompt als <Audio 1>, <Audio 2>, … adressiert. Das Modell verwendet jeden Clip je nach Prompt-Formulierung für Stimmklang, Soundeffekte oder Hintergrundmusik. Das veraltete singuläre Feld audio_url mappt auf dieselbe Content-Form und entspricht nun der Übergabe eines einelementigen reference_audio_urls.
reference_audio_urls darf nicht die einzige Referenzeingabe sein. Das Modell verlangt neben einem beliebigen Audio-Donor mindestens eine Bild- oder Video-Referenz. Kombinieren Sie reference_audio_urls mit reference_image_urls, reference_video_urls, image_url oder video_url – reine Audio-Übermittlungen werden abgelehnt.

Anfragegröße

Der Queue-Endpunkt akzeptiert JSON-Bodies bis 35 MB. Inline-Data-URLs für große Videos können diese Grenze überschreiten – insbesondere für Multi-Clip-Stitch bevorzugen Sie URLs gegenüber Inline-Base64.

Preisgestaltung

Rufen Sie POST /api/v1/video/quote auf, um für eine bestimmte Anfrageform ein Angebot zu erhalten, bevor Sie sie an /video/queue senden. Der Quote-Endpunkt ist die einzige autoritative Quelle; Preisdetails können sich ändern und sollten nicht clientseitig gecacht oder dupliziert werden. Wenn Referenzvideos Teil der Anfrage sind, geben Sie auch reference_video_total_duration (die Summe aller Referenzclip-Dauern in Sekunden) an, damit das Angebot dem entspricht, was /video/queue in Rechnung stellen wird:
Quellabgeglichenes Seedance 2.5 Edit-Angebot (Abrechnung anhand der Quelllänge):

Vollständige Beispiele

Alle Beispiele gehen davon aus, dass VENICE_API_KEY in der Umgebung gesetzt ist.

Text-to-Video

Seedance 2.0 Text-to-Video (4K)

Seedance 2.5 Text-to-Video (längere Dauer)

Image-to-Video (Erstes Frame)

Seedance-I2V-Modelle (seedance-2-0-image-to-video-basic, seine Fast-Variante und seedance-2-5-image-to-video-basic) akzeptieren aspect_ratio nicht – das Ausgabe-Seitenverhältnis wird automatisch aus den Abmessungen des Eingabebildes abgeleitet. Wird das Feld übergeben, kommt ein 400-Fehler mit “This model does not support aspect_ratio” zurück. Verwenden Sie die T2V- oder R2V-Varianten, wenn Sie explizite Kontrolle über das Seitenverhältnis benötigen.

Reference-Workflow – Motiv-Donor

Seedance 2.5 Reference-Workflow – Multi-Image

Reference-Workflow – Motiv- + Audio-Donor

Edit-Workflow

Seedance 2.5 Edit — quellabgeglichene Dauer und Seitenverhältnis

duration: "auto" (oder "-1") und aspect_ratio: "adaptive" (oder "auto") bewirken, dass die Ausgabe dem Quellclip folgt. Siehe Quellabgeglichenes Seitenverhältnis und Dauer.

Edit-Workflow mit Bild-Verankerung

Extend vorwärts

Stitch (3 Clips)

Polling auf Abschluss

Nach jeder Queue-Übermittlung speichern Sie die zurückgegebene queue_id und pollen /video/retrieve, bis der Response-Body vom Typ video/mp4 ist:
Die Antwort ist JSON ({ "status": "queued" | "running" | "failed", ... }), bis der Job abgeschlossen ist; ab diesem Zeitpunkt wechselt der Response-Body zu video/mp4-Bytes. Siehe Video Generation für das vollständige Polling-Muster.

Fehlerbehebung

At least one reference is required for this model

Reference-to-Video-Übermittlungen müssen mindestens eines von reference_image_urls, reference_video_urls, image_references oder video_references enthalten. Reine Textgenerierung ist kein gültiger R2V-Workflow – verwenden Sie stattdessen eine Text-to-Video-Model-ID. reference_audio_urls allein reicht nicht aus (siehe Audio-Abschnitt oben).

Zu viele Referenzvideos / -bilder

Seedance 2.0 begrenzt R2V auf 9 Bilder und 3 Videos. Seedance 2.5 hebt diese Obergrenzen auf 30 Bilder und 10 Videos an. Wenn Sie das Familien-Limit überschreiten, kürzen Sie die Eingaben oder fügen Sie sie zuvor offline zusammen.

Fehler bei Dauer / Gesamtdauer

  • 2.0: Referenzvideo/-audio pro Clip [2, 15] s; kombiniert Video/Audio ≤ 15 s; Ausgabe 4–15 s.
  • 2.5: Referenzvideo/-audio pro Clip [2, 30] s; kombiniert Video/Audio ≤ 30 s; Ausgabe 4–30 s.
  • Quellabgeglichene Dauer (-1 / auto bei Seedance 2.5): Quellclip muss 4–30 s sein, und reference_video_urls (Queue) bzw. reference_video_total_duration (Quote) ist erforderlich.
Kürzen Sie Clips clientseitig vor dem Übermitteln.

Prompt wird dem falschen Workflow zugeordnet

Der Workflow wird aus der Prompt-Syntax abgeleitet. Häufige Fehlrouten:
  • Extend gewollt, aber Refer to ... geschrieben → das Modell behandelt Ihr Video als Donor, nicht als fortzusetzende Leinwand
  • Stitch gewollt, aber Refer to ... geschrieben → das Modell wählt einen als Donor und ignoriert die anderen
  • Edit gewollt, aber Generate a video based on <Video 1> geschrieben → mehrdeutig; das Modell greift möglicherweise auf Reference zurück
Verwenden Sie die kanonischen Präfixe exakt wie geschrieben: Strictly edit <Video 1>, ..., Extend <Video 1>, ..., <Video 1> + ... + followed by <Video 2>.

Nicht unterstützte Medien mit Personen

Die öffentlichen Seedance-API-Modelle unterstützen keine Medien mit erkennbaren Personen. Solche Eingaben können mit einem Content-Policy- oder Provider-Fehler fehlschlagen. Verwenden Sie stattdessen die Venice-App oder Studio.

Angebot entspricht nicht dem in Rechnung gestellten Betrag

Wenn Sie ein Referenzvideo eingeschlossen, aber reference_video_total_duration nicht an /video/quote übergeben haben, können sich Angebot und in Rechnung gestellter Betrag unterscheiden. Übergeben Sie immer reference_video_total_duration (Summe aller Referenzclip-Dauern in Sekunden), wenn Referenzvideos vorhanden sind.

Referenzen