> ## Documentation Index
> Fetch the complete documentation index at: https://docs.venice.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Seedance 2.0 & 2.5
> Videos mit Seedance 2.0 und 2.5 auf Venice generieren, bearbeiten, verlängern und zusammenfügen – Text-, Bild- und Reference-to-Video-Workflows, Medienrichtlinie der öffentlichen API und familienspezifische multimodale Limits.
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
| Model ID | Variante | Ausgabeauflösungen | Hinweise |
| -------------------------------------------- | -------- | ---------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `seedance-2-0-text-to-video-basic` | T2V | 480p / 720p / 1080p / **4k** | Nur Text-Prompt |
| `seedance-2-0-image-to-video-basic` | I2V | 480p / 720p / 1080p / **4k** | Verankerung über Erstes-Frame-Bild (optional auch Letztes-Frame-Bild) |
| `seedance-2-0-reference-to-video-basic` | R2V | 480p / 720p / 1080p / **4k** | Bis zu 9 Referenzbilder + 3 Referenzvideos + 3 Referenzaudio-Donors. Treibt Reference / Edit / Extend / Stitch an |
| `seedance-2-0-fast-text-to-video-basic` | Fast T2V | 480p / 720p | Schnellere Stufe mit geringerer Detailtreue (kein 1080p / 4k) |
| `seedance-2-0-fast-image-to-video-basic` | Fast I2V | 480p / 720p | Schnellere Stufe mit geringerer Detailtreue (kein 1080p / 4k) |
| `seedance-2-0-fast-reference-to-video-basic` | Fast R2V | 480p / 720p | Schnellere Stufe mit geringerer Detailtreue (kein 1080p / 4k); gleicher Workflow-Umfang |
| `seedance-2-5-text-to-video-basic` | T2V | 480p / 720p | Bis zu 30 s Ausgabe; natives Audio |
| `seedance-2-5-image-to-video-basic` | I2V | 480p / 720p | Bis zu 30 s Ausgabe; Verankerung über Erstes-Frame (optional auch Letztes-Frame) |
| `seedance-2-5-reference-to-video-basic` | R2V | 480p / 720p | Bis zu 30 Bilder + 10 Videos + 10 Audio-Donors; gleiche Reference- / Edit- / Extend- / Stitch-Workflows |
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](/guides/media/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.
| Workflow | Zweck | Prompt-Präfix | Eingaben |
| ------------- | ------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **Reference** | Generiert ein neues Video und verwendet hochgeladene Referenzdateien als Donors für Motiv / Bewegung / Stil / Audio | `Refer to ... in to generate ...` | Text + ≥1 Bild- ODER Video-Referenz, plus optionale Audio-Donors (Anzahl je nach Familie unterschiedlich – siehe Limits) |
| **Edit** | Modifiziert ein einzelnes Eingabevideo unter Beibehaltung des Rests | `Strictly edit , changing its ...` | 1 Eingabevideo + Text (Bilder als optionale Verankerung) |
| **Extend** | Vorwärts- oder Rückwärtsverlängerung eines Clips | `Extend , generate ...` | 1 Eingabevideo + Text |
| **Stitch** | Fügt Eingabeclips mit automatisch generierten Übergängen zusammen | ` + + followed by + ...` | Mehrere Eingabevideos + Text (Clip-Anzahl / Dauer-Obergrenzen je nach Familie unterschiedlich) |
Die **Prompt-Syntax ist kanonisch und Groß-/Kleinschreibung-sensitiv**: spitze Klammern, großer Anfangsbuchstabe, ein Leerzeichen vor der Nummer – ``, ``, ``.
***
## 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 in to generate ...
Refer to the [action | camera scene | style | sound effect] in to generate ...
Refer to the [tone | timbre] in to generate ...
```
**Beispiele**:
* `Refer to in to generate a 5-second clip of the same character riding a horse through snow.`
* `Refer to the camera scene in to generate a similar establishing shot of a futuristic city at dawn.`
* `Refer to in and use the timbre in 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 , changing its [original feature] to [new feature] ...
```
**Untermuster für feinere Kontrolle**:
```
Add Elements:
At [timestamp / timing] and [spatial location] of , add [description of intended element].
Remove Elements:
Remove [element to be deleted] from , keeping the rest of the video content unchanged.
Modify Elements:
Replace [description of element to be changed] in with [description of intended element].
```
**Beispiele**:
* `Strictly edit , changing its weather from sunny to a heavy rainstorm.`
* `Add snacks such as fried chicken and pizza to the countertop in .`
* `Remove the red car from , keeping the rest of the video content unchanged.`
* `Replace the perfume featured in with the face cream from , with all original motions and camera work preserved.`
Das letzte Beispiel kombiniert Edit mit einer Bildreferenz – völlig zulässig, das Modell verwendet `` 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:
| Feld | Werte | Verhalten |
| -------------- | ---------------------- | ------------------------------------------------------------------------------------------- |
| `aspect_ratio` | `adaptive` oder `auto` | Ausgabe-Seitenverhältnis entspricht dem Quellvideo (Seedance 2.0 und 2.5 R2V) |
| `duration` | `-1` oder `auto` | Ausgabelänge entspricht dem Quellvideo (Seedance **2.5** R2V Edit; Quelle muss 4–30 s sein) |
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:
```
Extend , generate [description of extended content]
Extend backward, [description of extended content]
Extend , start with , then [description of extended content] ← behält Input am Anfang bei
Extend backward, [description], and then end with ← behält Input am Ende bei
```
Übergangsbehandlung: Das Modell extrahiert automatisch die Übergangsframes für nahtloses Blending, und die ursprünglichen Segmente des Eingabevideos werden nicht neu generiert.
**Beispiele**:
* `Extend , generate a dramatic chase scene through narrow alleys at dusk.`
* `Extend backward, the same character walking toward the camera before the original shot begins.`
* `Extend , start with , 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](#multimodal-input-limits) (Seedance 2.0: ≤3 Clips / ≤15 s kombiniert; Seedance 2.5: höhere Video-Obergrenzen).
**Kanonisches Prompt-Muster**:
```
+ [transition description] + followed by [+ [transition description] + followed by ]
```
**Beispiele**:
* ` + a smooth seamless cut + followed by `
* `. 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 .`
* ` + a wisp of smoke transforms into a flock of birds + followed by + a slow dolly-in + followed by `
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 + Environment (Optional)
+ Camera Movement / Cut (Optional)
+ Aesthetic Description (Optional)
+ Audio (Optional)
```
* **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 , changing its `), 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
| Einschränkung | Wert |
| ------------------------------------ | ------------------------------------------------------------------- |
| Eingabewege für Bild / Video / Audio | URL (`http://`, `https://`) oder Base64-Data-URL |
| Bildformate | `.jpeg`, `.png`, `.webp`, `.bmp`, `.tiff`, `.gif`, `.heic`, `.heif` |
| Bild-Seitenverhältnis (B / H) | exklusiv `(0.4, 2.5)` |
| Bild-Mindestseite | ≥ 300 px |
| Videoformate | `.mp4`, `.mov` |
| Video-Codecs | H.264 / AVC, H.265 / HEVC |
| Audio-Codecs (im Container) | AAC, MP3 |
| Audioformate (Referenzaudio) | `.wav`, `.mp3` |
| Videogröße pro Clip | ≤ 50 MB |
| Audiogröße pro Clip | ≤ 15 MB |
| I2V-Erste-Frame-Bilder | 1 |
| I2V-Erste- + Letzte-Frame | 2 |
### Familienvergleich
| Einschränkung | Seedance 2.0 (+ Fast) | Seedance 2.5 |
| ------------------------------- | ---------------------------------------------------- | -------------------- |
| Ausgabedauer | 4–15 s | 4–30 s (Standard 10) |
| Ausgabeauflösungen | 480p / 720p / 1080p / **4k** (Fast: nur 480p / 720p) | nur 480p / 720p |
| R2V-Referenzbilder | 1–9 | 1–30 |
| Max. Bytes pro R2V-Referenzbild | (gemeinsame Anfrage-Limits) | ≤ 30 MB pro Bild |
| R2V-Referenzvideos | ≤ 3 | ≤ 10 |
| Dauer pro Referenzvideo | `[2, 15]` s | `[2, 30]` s |
| Kombinierte Referenzvideo-Dauer | ≤ 15 s | ≤ 30 s |
| R2V-Referenzaudio-Clips | ≤ 3 | ≤ 10 |
| Dauer pro Referenzaudio | `[2, 15]` s | `[2, 30]` s |
| Kombinierte Referenzaudio-Dauer | ≤ 15 s | ≤ 30 s |
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 ``, ``, … 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:
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/quote \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-reference-to-video-basic",
"duration": "5s",
"resolution": "1080p",
"aspect_ratio": "16:9",
"reference_video_total_duration": 5
}'
```
Quellabgeglichenes Seedance 2.5 Edit-Angebot (Abrechnung anhand der Quelllänge):
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/quote \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-5-reference-to-video-basic",
"duration": "auto",
"resolution": "720p",
"aspect_ratio": "adaptive",
"reference_video_total_duration": 5.2
}'
```
***
## Vollständige Beispiele
Alle Beispiele gehen davon aus, dass `VENICE_API_KEY` in der Umgebung gesetzt ist.
### Text-to-Video
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-text-to-video-basic",
"prompt": "A golden retriever frolicking through a sunlit meadow at sunset, slow camera dolly-in, shallow depth of field, warm cinematic lighting.",
"duration": "5s",
"aspect_ratio": "16:9",
"resolution": "1080p"
}'
```
### Seedance 2.0 Text-to-Video (4K)
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-text-to-video-basic",
"prompt": "Ultra-detailed aerial glide over a sunlit alpine lake, crystal water, distant peaks, cinematic color grade.",
"duration": "5s",
"aspect_ratio": "16:9",
"resolution": "4k"
}'
```
### Seedance 2.5 Text-to-Video (längere Dauer)
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-5-text-to-video-basic",
"prompt": "A slow aerial push over misty mountains at sunrise, clouds parting, soft orchestral ambience, cinematic widescreen framing.",
"duration": "20s",
"aspect_ratio": "16:9",
"resolution": "720p"
}'
```
### Image-to-Video (Erstes Frame)
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-image-to-video-basic",
"prompt": "The lighthouse keeper turns toward the storm, lantern raised, waves crashing against the rocks.",
"image_url": "https://example.com/lighthouse.jpg",
"duration": "5s",
"resolution": "720p"
}'
```
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
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-reference-to-video-basic",
"prompt": "Refer to in to generate a 5-second clip of the same character walking through a neon-lit Tokyo street at night.",
"reference_image_urls": ["https://example.com/character.png"],
"duration": "5s",
"aspect_ratio": "9:16",
"resolution": "1080p"
}'
```
### Seedance 2.5 Reference-Workflow – Multi-Image
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-5-reference-to-video-basic",
"prompt": "Refer to in and the style in to generate a 12-second clip of the same character exploring a rainy cyberpunk alley.",
"reference_image_urls": [
"https://example.com/character.png",
"https://example.com/style-board.png"
],
"duration": "12s",
"aspect_ratio": "9:16",
"resolution": "720p"
}'
```
### Reference-Workflow – Motiv- + Audio-Donor
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-reference-to-video-basic",
"prompt": "Refer to in to generate a 5-second clip of the same character walking through a neon-lit Tokyo street at night. Refer to the timbre in for a soft female voiceover describing the scene.",
"reference_image_urls": ["https://example.com/character.png"],
"reference_audio_urls": ["https://example.com/voice-sample.mp3"],
"duration": "5s",
"aspect_ratio": "9:16",
"resolution": "1080p"
}'
```
### Edit-Workflow
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-reference-to-video-basic",
"prompt": "Strictly edit , changing its weather from sunny to a heavy rainstorm, with all original motions and camera work preserved.",
"reference_video_urls": ["https://example.com/sunny-scene.mp4"],
"duration": "5s",
"aspect_ratio": "adaptive",
"resolution": "1080p"
}'
```
### Seedance 2.5 Edit — quellabgeglichene Dauer und Seitenverhältnis
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-5-reference-to-video-basic",
"prompt": "Strictly edit , changing its weather from sunny to a heavy rainstorm, with all original motions and camera work preserved.",
"reference_video_urls": ["https://example.com/sunny-scene.mp4"],
"duration": "auto",
"aspect_ratio": "adaptive",
"resolution": "720p"
}'
```
`duration: "auto"` (oder `"-1"`) und `aspect_ratio: "adaptive"` (oder `"auto"`) bewirken, dass die Ausgabe dem Quellclip folgt. Siehe [Quellabgeglichenes Seitenverhältnis und Dauer](#source-matched-aspect-ratio-and-duration).
### Edit-Workflow mit Bild-Verankerung
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-reference-to-video-basic",
"prompt": "Replace the perfume featured in with the face cream from , with all original motions and camera work preserved.",
"reference_video_urls": ["https://example.com/perfume-ad.mp4"],
"reference_image_urls": ["https://example.com/face-cream.png"],
"duration": "5s",
"aspect_ratio": "adaptive",
"resolution": "1080p"
}'
```
### Extend vorwärts
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-reference-to-video-basic",
"prompt": "Extend , generate a dramatic chase scene through narrow alleys at dusk, with neon signs flickering and rain on the pavement.",
"reference_video_urls": ["https://example.com/alley-intro.mp4"],
"duration": "5s",
"aspect_ratio": "adaptive",
"resolution": "1080p"
}'
```
### Stitch (3 Clips)
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-reference-to-video-basic",
"prompt": " + a wisp of smoke transforms into a flock of birds + followed by + a slow dolly-in + followed by ",
"reference_video_urls": [
"https://example.com/clip-1.mp4",
"https://example.com/clip-2.mp4",
"https://example.com/clip-3.mp4"
],
"reference_video_total_duration": 12,
"duration": "5s",
"aspect_ratio": "16:9",
"resolution": "1080p"
}'
```
### 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:
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/retrieve \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-reference-to-video-basic",
"queue_id": "123e4567-e89b-12d3-a456-426614174000"
}' \
-o output.mp4
```
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](/guides/media/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 ` geschrieben → mehrdeutig; das Modell greift möglicherweise auf Reference zurück
Verwenden Sie die kanonischen Präfixe exakt wie geschrieben: `Strictly edit , ...`, `Extend , ...`, ` + ... + followed by `.
### 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
* Venice Video-Queue-Endpunkt: [`POST /api/v1/video/queue`](/api-reference/endpoint/video/queue)
* Venice Quote-Endpunkt: [`POST /api/v1/video/quote`](/api-reference/endpoint/video/quote)
* Ergänzender Leitfaden: [Reference to Video](/guides/media/reference-to-video) (behandelt Kling O3 + Grok Imagine R2V)
* Ergänzender Leitfaden: [Video Generation](/guides/media/video-generation) (Übersicht über Queue / Polling)