Einführung
Seedance 2.0 Mini Referenz-zu-Video führt mehrere freigegebene Quellen in einer Einstellung zusammen: Bilder für das Wer und Was, Clips für Bewegung und Tempo, Audio für den Takt, auf dem der Schnitt landet. Ein Startbild nimmt dieser Endpunkt nicht an.
Seedance 2.0 Mini ist die kleinste Stufe der Seedance-2.0-Reihe von ByteDance. Sie bietet dieselben 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 | Ja | Pflicht, und hier übernimmt er auch das Casting. Referenzen werden in der Reihenfolge zitiert, in der Sie sie senden. mindestens 1 Zeichen |
reference_image_urls | Nein | Bis zu 9 Bilder, die Sie verwenden dürfen, für eine Figur, ein Produkt, einen Stil oder ein Set. höchstens 9 Einträge |
reference_video_urls | Nein | Bis zu 3 Clips für Bewegung, Tempo oder Kamerasprache. höchstens 3 Einträge |
reference_audio_urls | Nein | Bis zu 3 Audiodateien, je 2 bis 15 Sekunden und zusammen höchstens 15 Sekunden, jede unter 15 MB, als klanglicher Anker – Sprechweise, Tempo, eine musikalische Phrase –, an dem… höchstens 3 Einträge |
aspect_ratio | Nein | Ausgabeformat, standardmäßig adaptive: Der Clip übernimmt die Form der Hauptreferenz. |
resolution | Nein | Ausgabeauflösung: 480p oder standardmäßig 720p. Sie wählt eine Tarifstufe und schärft keine niedrig aufgelösten Referenzen. |
duration_seconds | Nein | Länge des fertigen Clips in ganzen Sekunden, 4 bis 15, Vorgabe 5; 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
Referenzclips zählen zu den berechneten Sekunden. Da wir deine Clips vor dem Lauf nicht messen können, reservieren wir zunächst den Betrag für die maximalen 15 Sekunden und geben den nicht genutzten Teil bei der Abrechnung sofort wieder frei — berechnet werden nur die tatsächlich genutzten Sekunden.
| Spezifikation | Preis |
|---|---|
| $0.010969 / Sekunde |
| $0.023588 / Sekunde |
| $0.0246078 / Sekunde |
| $0.05292 / Sekunde |
| $0.036 / Sekunde |
| $0.072 / Sekunde |
Anwendungsfälle
Ein Referenz-Set für eine ganze Serie
Drei Ansichten eines Mannes – frontal, im Dreiviertelprofil und im Profil – plus ein viertes Bild seiner Schürze tragen eine ganze Serie, während sich zwischen den Anfragen nur der Prompt ändert. Das veröffentlichte Bäckerei-Beispiel ist genau so aufgebaut.
Tempo aus einem Clip übernehmen
Ein Referenzclip kann Rhythmus statt Inhalt liefern. Ein Beispiel übernimmt eine ruhige, durchgehende Kamerafahrt aus einem Clip, inszeniert sie in einem Gang aus einem Referenzbild und setzt die Schritte auf den Puls einer Referenz-Tonspur – acht Sekunden in 9:16.
Ein Paar über mehrere Winkel stabil halten
Drei Bilder desselben Paares erlauben einer neuen Einstellung einen dritten Blickwinkel, während Gesichter und Kleidung gleich bleiben – so wie im Parkbank-Beispiel in 480p.
Prompt-Leitfaden und Praxistipps
Jede Referenz über ihre Position benennen
Der Prompt ist Pflicht und übernimmt die Besetzung, denn Referenzen werden in der Reihenfolge gelesen, in der Sie sie senden. Schreiben Sie „References 1-3 are …“ oder nutzen Sie @Image1, @Image2, damit jede Quelle genau eine Aufgabe hat.
Die Obergrenzen kennen
Senden Sie bis zu 9 Bilder, 3 Clips und 3 Tonspuren, in jeder Anfrage mindestens ein Bild oder einen Clip. Clips und Audio dauern je 2 bis 15 Sekunden und zusammen höchstens 15 Sekunden, und die Sekunden Ihrer Referenzclips werden zusätzlich zur Ausgabe abgerechnet.
Das mitgelieferte Beispiel anpassen
Das veröffentlichte Beispiel nutzt aspect_ratio 16:9, duration_seconds 6, generate_audio true und resolution 720p, mit vier Bildern in reference_image_urls.
@Image1, @Image2 and @Image3 are the same man from front, three-quarter and profile; @Image4 is his apron. Put him behind the counter of a small bakery at opening time in that apron, sliding a tray into the case and glancing up as the door chimes. Warm ovens, flat morning light.
Drei Winkel halten das Gesicht, das vierte Bild hält das Kostüm, und der Prompt sagt, was was ist. Behalten Sie diese Aufteilung bei, wenn Sie Ihre eigene Figur besetzen.
Exaktes Startbild nötig? Bild-zu-Video nutzen
Dieser Endpunkt hat kein Feld für Start- oder Schlussbild. Muss das Eröffnungsbild exakt einem Foto entsprechen, schicken Sie dieses Foto an Bild-zu-Video und beschreiben nur die Bewegung.
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/reference-to-video",
"input": {
"aspect_ratio": "adaptive",
"bitrate_mode": "standard",
"duration_seconds": 5,
"enable_web_search": false,
"generate_audio": true,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"reference_image_urls": [
"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.
















