Einführung
Seedance 2.0 Mini Text-zu-Video baut das gesamte Bild aus dem Prompt – Motiv, Set, Kamera, Licht – und erzeugt die Tonspur im selben Durchgang. Es ist der Endpunkt für Aufnahmen, die niemand drehen wird.
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 | Die einzige Quelle dessen, was auf dem Bild erscheint. Ordnen Sie ihn als Motiv, Handlung, Kamera, Licht, Ton, ein Gedanke pro Satz. mindestens 1 Zeichen |
aspect_ratio | Nein | Ausgabeformat, standardmäßig adaptive, oder eines von sechs festen Verhältnissen von 21:9 bis 9:16. |
resolution | Nein | Ausgabeauflösung: 480p oder standardmäßig 720p. Sie wählt eine Tarifstufe, höhere Stufen bedeuten größere Dateien und längere Renderzeiten. |
duration_seconds | Nein | Länge des fertigen Clips in ganzen Sekunden, 4 bis 15, Vorgabe 5, und zugleich die abgerechnete Menge – die Kosten wachsen direkt mit. |
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 |
Anwendungsfälle
Alltags-B-Roll in großer Menge
Morgenlicht durchs Fenster, eine Bettdecke über dem Gesicht, Staub im Sonnenstrahl: die gewöhnlichen Einstellungen, die ein Katalog oder eine App zu Hunderten braucht und für die niemand einen Dreh planen will. Das Beispiel unten ist genau das, erzeugt allein aus einem Prompt.
Ein Briefing in jedem Format
Fixieren Sie den Prompt und schicken Sie ihn im selben Batch in 16:9, 9:16 und 1:1 los. Da der Endpunkt asynchron arbeitet, sind drei Formate derselben Idee drei Task-IDs zum Einsammeln, nicht drei Aufträge zum Planen.
Viele Looks aus einer Anfrageform
Dieselben Felder decken Realfilm und stilisierte Animation ab. Unter den Beispielen dieses Endpunkts sind eine regennasse Straße bei Nacht mit Teleobjektiv und eine Anime-Szene im Cel-Shading an einer verschneiten heißen Quelle. Den Look bestimmt der Prompt, ein zusätzliches Feld gibt es dafür nicht.
Prompt-Leitfaden und Praxistipps
Motiv, Handlung, Kamera, Licht, Ton
Ein Gedanke pro Satz, in dieser Reihenfolge. Wenn ein längeres duration_seconds zusätzliche Zeit bringt, nutzen Sie sie, um die beschriebene Handlung zu Ende zu führen, statt eine zweite hinzuzufügen.
Umformulieren, was Seedance ablehnt
Wir prüfen Formulierungen nicht, aber Seedances eigene Ebene lehnt einen Teil davon vor dem Rendern ab; Küssen ist der zuverlässige Auslöser. Derselbe Moment als Flüstern am Ohr oder Stirn an Stirn geht durch, und ein Startbild in Bild-zu-Video bringt die wörtliche Version durch.
Das mitgelieferte Beispiel anpassen
Das veröffentlichte Beispiel nutzt aspect_ratio 16:9, duration_seconds 5, generate_audio true und resolution 720p.
Morning in a sunlit studio apartment. An adult woman in an oversized grey t-shirt stretches her arms overhead beside the window, the hem lifting slightly, then drops onto the unmade bed and pulls the duvet over her face laughing. Warm dust in the light shaft, handheld, soft film grain, quiet room tone and distant traffic.
Gewöhnliches Material mit Handkamera-Gefühl und leiser Raumatmo – genau wofür diese Stufe gedacht ist. Ändern Sie Raum und Geste und behalten Sie die Struktur mit einer einzigen Handlung bei.
Ton nur abschalten, wenn später vertont wird
generate_audio abzuschalten ändert den Preis in dieser Stufe nicht. Lassen Sie den Ton an, wenn Atmo die Szene trägt, und schalten Sie ihn für stumme Loops oder spätere Musik in der Postproduktion ab.
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/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"aspect_ratio": "adaptive",
"bitrate_mode": "standard",
"generate_audio": true,
"duration_seconds": 5
}
}'
# 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.
