curl-Beispiele.
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: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: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.
<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 mitceil(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 optionalaspect_ratio: "adaptive". Quellabgeglichenedurationist 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: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:<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>
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
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.
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 SiePOST /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:
Vollständige Beispiele
Alle Beispiele gehen davon aus, dassVENICE_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ückgegebenequeue_id und pollen /video/retrieve, bis der Response-Body vom Typ video/mp4 ist:
{ "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/autobei Seedance 2.5): Quellclip muss 4–30 s sein, undreference_video_urls(Queue) bzw.reference_video_total_duration(Quote) ist erforderlich.
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
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, aberreference_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
- Venice Video-Queue-Endpunkt:
POST /api/v1/video/queue - Venice Quote-Endpunkt:
POST /api/v1/video/quote - Ergänzender Leitfaden: Reference to Video (behandelt Kling O3 + Grok Imagine R2V)
- Ergänzender Leitfaden: Video Generation (Übersicht über Queue / Polling)