Einführung
Seedance 2.0 Fast Bild-zu-Video beginnt den Clip mit einem Bild, das Sie liefern, und animiert es bis zu 15 Sekunden lang. Geben Sie ein Schlussbild dazu, muss die Einstellung dort ankommen – so werden Übergänge und Vorher-nachher-Paare wiederholbar.
Seedance 2.0 Fast ist die schnelle Stufe der Seedance-2.0-Reihe von ByteDance. Die drei Endpunkte liefern Clips von 4 bis 15 Sekunden in 480p oder 720p, mit Ton, der zusammen mit dem Bild entsteht.
Seedance-2.0-Fast-Modus nach Ausgangsmaterial wählen
| Ausgangsmaterial | Modus |
|---|---|
| Ein Skript oder eine Szenenbeschreibung | Seedance 2.0 Fast Text-zu-Video |
| Ein freigegebenes Startbild | Seedance 2.0 Fast Bild-zu-Video |
| Getrennte Referenzen für Aussehen, Bewegung oder Ton | Seedance 2.0 Fast Referenz-zu-Video |
Wichtige Funktionen und Highlights
Ein Feldsatz, drei Quellen
Alle drei Endpunkte nehmen dieselben Kernfelder an: prompt, duration_seconds von 4 bis 15 (oder -1, wenn das Modell die Länge wählen soll), resolution mit 480p oder 720p, aspect_ratio, generate_audio und seed. Unterschiedlich ist nur, was das Bild verankert: nichts, ein Startbild oder eine Reihe von Referenzen. Eine Anfrage wechselt den Modus, indem Sie diese Quelle hinzufügen oder weglassen.
Bild und Ton in einem Durchgang
generate_audio ist standardmäßig aktiv und erzeugt Atmo, Bewegungsgeräusche und Stimmen synchron zum Bild. Abschalten senkt den Preis in dieser Stufe nicht; schalten Sie den Ton also nur für stumme Loops oder für Material ab, das Sie später vertonen.
Adaptives Format als Standard
aspect_ratio steht standardmäßig auf adaptive: Bild-zu-Video übernimmt die Proportionen des Startbilds, Referenz-zu-Video folgt der wichtigsten Referenz, und bei Text-zu-Video wählt das Modell das Format, das der Prompt nahelegt. Die sechs festen Formate 16:9, 9:16, 4:3, 3:4, 1:1 und 21:9 stehen bereit, wenn der Ausspielort das Format vorgibt.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Nein | Optional, aber lohnend: Beschreiben Sie, was nach dem Bild passiert, statt Sichtbares zu wiederholen – die Handlung, die Kamerabewegung, das Vergehen der Zeit, den Ton. mindestens 1 Zeichen |
image_url | Ja | Öffentlicher, direkt herunterladbarer Link auf das erste Bild; Pflicht. |
last_image_url | Nein | Optionales Schlussbild. Es bestimmt das Bild, auf dem die Einstellung endet: ein Übergang, ein Vorher-nachher-Paar oder ein Loop, der mit demselben Bild beginnt und endet. |
aspect_ratio | Nein | Ausgabeformat, standardmäßig adaptive: Der Clip übernimmt die Proportionen Ihres Startbilds, es wird also nichts abgeschnitten. |
resolution | Nein | Ausgabeauflösung: 480p oder standardmäßig 720p. Sie wählt eine Tarifstufe und bestimmt nur das ausgelieferte Format – Detail, das der erste Frame nicht schon hat, kommt nicht dazu. |
duration_seconds | Nein | Länge des fertigen Clips in ganzen Sekunden, 4 bis 15, Vorgabe 5, und die abgerechnete Menge; mit -1 wählt das Modell die Länge, die Schätzung rechnet dann mit 15 Sekunden. |
generate_audio | Nein | Ob eine eigene Tonspur synchron zum Bild gerendert wird. Standardmäßig an; wenn Sie es abschalten, sinkt der Tarif in dieser Variante nicht. Standardwert: |
seed | Nein | Ganzzahliger Seed; ohne Angabe zieht jeder Lauf seinen eigenen. |
return_last_frame | Nein | Liefert zusätzlich zum Video das letzte Bild des Clips als eigenes Bild. Standardwert: |
bitrate_mode | Nein | Bitrate der gelieferten Datei: |
watermark | Nein | Fügt dem Video das eigene sichtbare Wasserzeichen „AI generated“ des Modells hinzu. Standardwert: |
Preis
| Spezifikation | Preis |
|---|---|
| $0.04499712 / Sekunde |
| $0.096768 / Sekunde |
Anwendungsfälle
Wörtliche Ergebnisse aus einem eigenen Bild
Was das Startbild zeigt, ist bereits im Clip. Der Prompt muss nur noch die Bewegung beschreiben und nicht für den Inhalt argumentieren. Das ist der verlässliche Weg, wenn Seedances eigener Filter dieselbe Szene als Text ablehnt.
Vorher-nachher und Übergänge
Senden Sie last_image_url zusammen mit image_url, und die Einstellung muss beim Schlussbild landen. Das veröffentlichte Beispiel füllt in zehn Sekunden bei fester Kamera einen leeren Raum mit Teppich, Sofa und Lampen – die Form einer Renovierungs-Enthüllung oder einer Produktverwandlung.
In 480p entwerfen, in 720p liefern
Fahren Sie günstige 480p-Durchgänge, bis Handlung und Bildausschnitt sitzen, und wiederholen Sie dieselbe Anfrage dann in 720p für den finalen Take. Die Auflösung ändert nur das Ausgabeformat; sie fügt keine Details hinzu, die das Startbild nicht schon hat.
Prompt-Leitfaden und Praxistipps
Zuerst das Bild vorbereiten
image_url legt Komposition, Aussehen des Motivs, Farblook und die Qualitätsobergrenze fest. Text, Wasserzeichen und Logos wandern ins Video, entfernen Sie sie also vorher. Jede Bildseite muss zwischen 300 und 6000 Pixeln liegen, sonst wird die Anfrage abgelehnt, bevor ein Rendering beginnt.
Beschreiben, was passiert, nicht was zu sehen ist
Der Prompt ist optional, lohnt sich aber: Nennen Sie Handlung, Kamerabewegung, Zeitverlauf und Ton. Eine Einstellung, die nur von einem Bild getragen wird, driftet umso mehr, je länger sie läuft. Prüfen Sie die Bewegung also bei 4 oder 5 Sekunden, bevor Sie für 15 bezahlen.
Das mitgelieferte Beispiel anpassen
Das veröffentlichte Beispiel nutzt aspect_ratio 16:9, duration_seconds 6, generate_audio true und resolution 720p, mit einem Ladenfront-Foto als image_url.
A hand reaches into frame and flips the door sign from CLOSED to OPEN, then withdraws; steam drifts off the machine behind the glass and the street reflection keeps moving. Camera stays where it is.
16:9 ist bewusst gesetzt, weil der Ausspielort Querformat verlangt, statt adaptive dem Bild folgen zu lassen. Behalten Sie die feste Kamera und eine klare Handlung bei, wenn Sie Ihr eigenes Bild einsetzen.
Beide Bilder im selben Format halten
Wenn Sie last_image_url hinzufügen, geben Sie ihm dieselben Proportionen wie dem Startbild; weichen sie ab, wird das Schlussbild passend beschnitten. Halten Sie Kamera und Licht zwischen beiden Bildern konstant und ändern Sie genau einen Zustand, sonst wird die Mitte des Clips zum Schnitt.
API-Schnellstart
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedance-2.0-fast/image-to-video",
"input": {
"aspect_ratio": "adaptive",
"bitrate_mode": "standard",
"duration_seconds": 5,
"generate_audio": true,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.
















