Einführung
Seedance 2.0 Mini 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 wiederholbar.
Seedance 2.0 Mini ist die kleinste Stufe der Seedance-2.0-Reihe von ByteDance. Sie bietet dieselben drei Endpunkte wie Seedance 2.0 Fast und liefert Clips von 4 bis 15 Sekunden in 480p oder 720p, mit Ton aus demselben Durchgang.
Seedance-2.0-Mini-Modus nach Ausgangsmaterial wählen
| Ausgangsmaterial | Modus |
|---|---|
| Ein Skript oder eine Szenenbeschreibung | Seedance 2.0 Mini Text-zu-Video |
| Ein freigegebenes Startbild | Seedance 2.0 Mini Bild-zu-Video |
| Getrennte Referenzen für Aussehen, Bewegung oder Ton | Seedance 2.0 Mini Referenz-zu-Video |
Wichtige Funktionen und Highlights
Derselbe Vertrag wie Seedance 2.0 Fast
Mini bietet dieselben Endpunkte und Felder wie Seedance 2.0 Fast: adaptives Format plus sechs feste Seitenverhältnisse, 4 bis 15 Sekunden oder -1 für eine vom Modell gewählte Länge, nativen Ton und seed – nur die Auflösung endet bei 720p. Eine Pipeline für Mini wechselt zu Fast, indem Sie die Modell-ID ändern, nicht die Anfrage.
Für Volumen gebaut
Mini ist die richtige Stufe, wenn Durchsatz wichtiger ist als die zusätzliche Qualität der größeren Seedance-2.0-Modelle. Jeder Endpunkt arbeitet asynchron: Senden Sie mit jeder Anfrage einen Idempotency-Key, speichern Sie die Task-IDs und lassen Sie Polling oder Callbacks die Ergebnisse abholen. Der Key gilt 24 Stunden, ein erneuter Versuch nach einem Verbindungsabbruch liefert also die ursprüngliche Aufgabe.
Längere Sequenzen mit Videoverlängerung
Um über fünfzehn Sekunden hinauszukommen, senden Sie einen fertigen Clip an den Endpunkt video-extend: Sein letztes Bild eröffnet eine neue Seedance-2.0-Mini-Einstellung, und Sie erhalten eine Datei mit beiden Teilen zurück. Jeder Schritt berechnet nur die Sekunden, die er hinzufügt, und das verbundene Ergebnis lässt sich erneut verlängern.
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: |
enable_web_search | Nein | Standardmäßig aus. Eingeschaltet kann das Modell vor dem Rendern im Web nach Informationen zu Ihrem Prompt suchen. 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.0246078 / Sekunde |
| $0.05292 / Sekunde |
| $0.036 / Sekunde |
| $0.072 / Sekunde |
Anwendungsfälle
Katalogfotos in Bewegung
Ein flaches Produkt- oder Regalfoto wird ohne Nachdreh zu ein paar Sekunden Bewegung. Das veröffentlichte Beispiel füllt in vier Sekunden bei fester Kamera ein Kühlregal Dose für Dose auf, mit leisem Klirren und Kühlschrankbrummen.
Ein Zeitraffer zwischen zwei Bildern
Mit last_image_url muss der Clip beim Schlussbild ankommen. Eines der Beispiele verwandelt denselben Weg in zehn Sekunden vom Spätsommer in den tiefen Herbst, mit fester Kamera und ohne Schnitt.
Momente, die der Textfilter ablehnen würde
Das Startbild trägt den Inhalt, der Prompt muss also nur die Bewegung beschreiben. Wenn Seedances eigene Ebene einen als Text formulierten Moment ablehnt, führt ein Startbild ans Ziel.
Prompt-Leitfaden und Praxistipps
Das Startbild vorbereiten
image_url ist Pflicht und legt Komposition, Look und Qualitätsobergrenze fest; jede Seite muss zwischen 300 und 6000 Pixeln liegen. Entfernen Sie Text, Wasserzeichen und Logos vorher, denn sie wandern ins Video.
Beschreiben, was sich ändert, nicht was da ist
Der Prompt ist optional. Beschreiben Sie Handlung, Kamerabewegung und Ton nach dem Startbild; ohne Prompt entscheidet das Modell die Bewegung selbst. Prüfen Sie die Bewegung bei 4 oder 5 Sekunden, bevor Sie für 15 bezahlen, denn eine Einstellung aus einem einzigen Bild driftet umso mehr, je länger sie läuft.
Das mitgelieferte Beispiel anpassen
Das veröffentlichte Beispiel nutzt aspect_ratio 16:9, duration_seconds 4, generate_audio true und resolution 720p, mit einem Regalfoto als image_url.
A gloved hand enters from the right and fills the gap in the upper row can by can, facing each label forward, then withdraws. Camera locked off on the shelf. Small metallic clinks, chiller hum, fluorescent light unchanged throughout.
Vier Sekunden reichen für eine klare Handlung bei fester Kamera. Setzen Sie Ihr eigenes Produktfoto ein und behalten Sie die eine Bewegung bei.
Dem Schlussbild dasselbe Format geben
last_image_url braucht dieselben Proportionen wie das Startbild, sonst wird es passend beschnitten. Halten Sie Kamera und Licht zwischen beiden Bildern konstant und ändern Sie einen klaren Zustand, etwa die Jahreszeit wie im Beispiel mit dem Weg.
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-mini/image-to-video",
"input": {
"aspect_ratio": "adaptive",
"bitrate_mode": "standard",
"duration_seconds": 5,
"enable_web_search": false,
"generate_audio": true,
"image_url": "https://example.com/reference.png"
}
}'
# 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.
