Wprowadzenie
Seedance 2.0 Mini w trybie tekst na wideo buduje cały kadr z promptu — postać, scenografię, kamerę, światło — i w tym samym przebiegu tworzy ścieżkę dźwiękową. To endpoint do ujęć, których nikt nie pojedzie nakręcić.
Seedance 2.0 Mini to najmniejszy wariant linii Seedance 2.0 od ByteDance. Udostępnia te same endpointy co Seedance 2.0 Fast i zwraca klipy od 4 do 15 sekund w 480p lub 720p, z dźwiękiem generowanym w tym samym przebiegu.
Wybierz tryb Seedance 2.0 Mini według materiału wyjściowego
| Materiał wyjściowy | Tryb |
|---|---|
| Scenariusz lub opis sceny | Seedance 2.0 Mini Tekst na wideo |
| Zatwierdzony kadr otwierający | Seedance 2.0 Mini Obraz na wideo |
| Osobne referencje wyglądu, ruchu lub dźwięku | Seedance 2.0 Mini Referencje na wideo |
Najważniejsze funkcje
Ten sam kontrakt co Seedance 2.0 Fast
Mini udostępnia te same endpointy i pola co Seedance 2.0 Fast: adaptacyjne proporcje i sześć stałych, od 4 do 15 sekund lub -1 dla długości wybranej przez model, natywny dźwięk i seed, a rozdzielczość kończy się na 720p. Pipeline napisany pod Mini przeniesiesz do Fast, zmieniając identyfikator modelu, a nie żądanie.
Stworzony do dużych wolumenów
Mini wybierasz, gdy przepustowość liczy się bardziej niż dodatkowa jakość większych modeli Seedance 2.0. Każdy endpoint jest asynchroniczny: wysyłaj Idempotency-Key z każdym żądaniem, zapisuj identyfikatory zadań i odbieraj wyniki przez polling lub callbacki. Klucz działa 24 godziny, więc ponowna próba po zerwanym połączeniu zwraca pierwotne zadanie.
Dłuższe sekwencje z przedłużaniem wideo
Żeby wyjść poza piętnaście sekund, wyślij gotowy klip do endpointu video-extend: jego ostatnia klatka otwiera nowe ujęcie Seedance 2.0 Mini, a w odpowiedzi dostajesz jeden plik z połączonymi częściami. Każdy krok rozlicza tylko sekundy, które dodaje, a połączony wynik można przedłużyć ponownie.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Jedyne źródło tego, co pojawi się na ekranie. Ułóż go tak: bohater, akcja, kamera, światło, dźwięk, jeden pomysł na zdanie. od 1 znaków |
aspect_ratio | Nie | Kadr wyjściowy: domyślnie adaptive albo jedna z sześciu stałych proporcji od 21:9 po 9:16. |
resolution | Nie | Rozdzielczość wyjściowa: 480p albo domyślne 720p. Wybiera próg cenowy, a wyższe progi oznaczają większe pliki i dłuższe renderowanie. |
duration_seconds | Nie | Długość gotowego klipu w pełnych sekundach, od 4 do 15, domyślnie 5, a zarazem rozliczana ilość – koszt rośnie wprost proporcjonalnie. |
generate_audio | Nie | Decyduje, czy powstaje własna ścieżka dźwiękowa zsynchronizowana z obrazem. Domyślnie włączone; wyłączenie nie obniża stawki na tym poziomie. Domyślnie: |
enable_web_search | Nie | Domyślnie wyłączone. Po włączeniu model może przed renderem wyszukać w sieci informacje związane z promptem. Domyślnie: |
seed | Nie | Całkowity seed; pominięty – każdy przebieg losuje własny. Ustal go przy wszystkim innym bez zmian, żeby ocenić, co naprawdę zmieniła poprawka w prompcie. |
return_last_frame | Nie | Oprócz wideo zwraca ostatnią klatkę klipu jako osobny obraz. Wyślij ją do image-to-video jako kolejną klatkę początkową, żeby łączyć ujęcia bez samodzielnego eksportowania kadru. Domyślnie: |
bitrate_mode | Nie | Bitrate dostarczanego pliku: |
watermark | Nie | Dodaje do wideo widoczny znak wodny „AI generated” samego modelu. Domyślnie wyłączone; włącz, gdy miejsce publikacji wymaga oznaczania materiałów wygenerowanych przez AI. Domyślnie: |
Cennik
| Specyfikacja | Cena |
|---|---|
| $0.0246078 / sekundę |
| $0.05292 / sekundę |
Zastosowania
Codzienny b-roll w dużych ilościach
Poranne światło przez okno, kołdra naciągnięta na twarz, kurz w smudze słońca: zwykłe ujęcia, których katalog albo aplikacja potrzebuje setkami i dla których nikt nie chce planować zdjęć. Opublikowany przykład poniżej to właśnie to, wygenerowane z samego promptu.
Jeden brief w każdym formacie
Ustal prompt i rozpisz go na 16:9, 9:16 i 1:1 w jednej partii. Endpoint jest asynchroniczny, więc trzy formaty jednego pomysłu to trzy identyfikatory zadań do odebrania, a nie trzy zlecenia do zaplanowania.
Wiele stylistyk przy tej samej postaci żądania
Te same pola obsługują zdjęcia aktorskie i stylizowaną animację. Wśród przykładów tego endpointu jest mokra od deszczu ulica nocą z teleobiektywu i scena anime w stylu cel-shading przy zaśnieżonym gorącym źródle; styl ustalasz w prompcie, bez dodatkowych pól.
Wskazówki
Postać, akcja, kamera, światło, dźwięk
Jedna myśl na zdanie, w tej kolejności. Gdy dłuższe duration_seconds daje ci dodatkowy czas, wykorzystaj go na dokończenie opisanej już akcji zamiast dodawać drugą.
Przeformułuj to, co Seedance odrzuca
Nie sprawdzamy sformułowań, ale własna warstwa Seedance odrzuca ich część przed generowaniem, a pocałunek niezawodnie wywołuje odmowę. Ta sama scena opisana jako szept do ucha albo zetknięte czoła przechodzi, a własny kadr otwierający w trybie obraz na wideo przepuszcza wersję dosłowną.
Dostosuj dołączony przykład
Opublikowany przykład używa aspect_ratio 16:9, duration_seconds 5, generate_audio true i 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.
Zwykły materiał z kamerą z ręki i cichym tłem pokoju — dokładnie to, do czego służy ten wariant. Zmień pokój i gest, a strukturę z jedną akcją zostaw.
Wyłączaj dźwięk tylko wtedy, gdy udźwiękowisz później
Wyłączenie generate_audio nie zmienia stawki w tym wariancie. Zostaw dźwięk, gdy tło buduje scenę, a wyłącz go w niemych pętlach albo gdy muzykę dodasz w postprodukcji.
Szybki start z API
# 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"
Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.
