Wprowadzenie
Seedance 1.5 Pro w trybie tekst na wideo buduje cały kadr z promptu i w tym samym przebiegu tworzy ścieżkę dźwiękową. camera_fixed decyduje, czy model wymyśli ruch kamery, czy utrzyma kadr całkowicie nieruchomo.
ByteDance Seedance 1.5 Pro udostępnia dwa endpointy: tekst na wideo i obraz na wideo. Oba zwracają klipy od 4 do 12 sekund w 480p, 720p lub 1080p z natywnym dźwiękiem i oba mają przełącznik camera_fixed.
Wybierz tryb Seedance 1.5 Pro według materiału wyjściowego
| Materiał wyjściowy | Tryb |
|---|---|
| Zatwierdzony kadr otwierający | Seedance 1.5 Pro Obraz na wideo |
| Scenariusz lub opis sceny | Seedance 1.5 Pro Tekst na wideo |
Najważniejsze funkcje
camera_fixed trzyma kadr
Przy false, wartości domyślnej, model sam wymyśla ruchy: dryf, najazd, powolny obrót wokół postaci. Przy true kamera staje, a postać dalej porusza się w kadrze. Nieruchomy kadr da się śledzić, kluczować, komponować albo zapętlić, a ani Seedance 2.0, ani 2.5 nie mają tego przełącznika.
Dźwięk w tym samym przebiegu
generate_audio ma domyślnie wartość true i tworzy tło, efekty ruchu oraz głos zsynchronizowane z klatkami. Przenosi to żądanie do wyższego progu cenowego, więc wyłączaj je w pętlach produktowych i planach, które udźwiękowisz później.
Jasny sufit
Klipy trwają od 4 do 12 pełnych sekund w 480p, 720p lub 1080p, w sześciu stałych proporcjach, z 16:9 jako domyślną i bez opcji adaptacyjnej. Nie ma endpointu referencji; seed jest dostępny w 480p i 720p. Zadania wymagające 4K, dłuższych ujęć albo obsady z wielu obrazów należą do Seedance 2.0 lub 2.5; tym, co zostaje przy 1.5 Pro, jest zablokowana kamera.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Jedyne źródło tego, co pojawi się na ekranie. od 3 znaków |
aspect_ratio | Nie | Wybiera kadrowanie spośród sześciu sztywnych wartości, domyślnie 16:9. Zmienia wyłącznie wycinek – nigdy długości ani ostrości. |
resolution | Nie | Rozdzielczość wyjścia, domyślnie 720p, a najwyżej 1080p; dla tego endpointu nic wyższego nie jest oferowane. |
duration_seconds | Nie | Długość gotowego klipu w pełnych sekundach, od 4 do 12, domyślnie 5. To rozliczana wielkość: podwój długość, a mniej więcej podwoisz koszt. |
generate_audio | Nie | Decyduje, czy natywna ścieżka dźwiękowa ma powstać w synchronie z obrazem. Domyślnie: |
camera_fixed | Nie | Blokuje kamerę, domyślnie false. Pozostawiony na false sprawia, że model dokłada własne ruchy. Domyślnie: |
seed | Nie | Liczba całkowita od 0 do 2147483647 dla losowego startu; pominięta – każdy przebieg losuje własną. |
Cennik
| Rozdzielczość | Generuj dźwięk: Nie | Generuj dźwięk: Tak |
|---|---|---|
| $0.0112 / sekundę | $0.0223 / sekundę |
| $0.0227 / sekundę | $0.0454 / sekundę |
| $0.0491 / sekundę | $0.0982 / sekundę |
Zastosowania
Nieruchome ujęcia do kompozycji
Włącz camera_fixed i opisz ruch, który dzieje się w kadrze. Opublikowany przykład to statyczne szerokie ujęcie, w którym porusza się tylko tkanina i oddech osoby: materiał, który można wykeyować, trackować lub zapętlić.
Kontrolowane porównanie promptów
Zablokuj kamerę, nie ruszaj pozostałych pól i zmieniaj jeden fragment na przebieg: źródło światła, obiektyw, jedną akcję. Ustal też seed (480p i 720p), a losowy start również zostanie w miejscu; seed to narzędzie do porównań, nie gwarancja identycznych klatek, więc porównuj kilka ujęć każdej wersji – przy zablokowanej kamerze różnica wynika ze sformułowania.
Malarskie i stylizowane looki
Prompt ustala nie tylko akcję, ale też wygląd. Jeden z przykładów tego endpointu prosi o światłocieniowy styl obrazu olejnego oświetlony wyłącznie świecami, z bardzo powolnym jazdem kamery i wyłączonym camera_fixed.
Wskazówki
Najpierw zdecyduj o kamerze
camera_fixed to pierwsza decyzja w tej generacji. Jeśli wynik ma być śledzony, kluczowany, zapętlony albo montowany z prawdziwym materiałem, ustaw true i powtórz blokadę w prompcie. Jeśli chcesz ruchu, zostaw false i go nazwij: najazd, panorama, pochył albo obrót.
Omijaj odmowy Seedance
Nie sprawdzamy sformułowań, ale własna warstwa bezpieczeństwa Seedance odrzuca ich część przed generowaniem. Pocałunek wywołuje to na pewno; szept do ucha czy zetknięte czoła przechodzą. Gdy scena ma być dosłowna, zacznij od własnego kadru w trybie obraz na wideo zamiast od promptu.
Dostosuj dołączony przykład
Opublikowany przykład używa aspect_ratio 16:9, camera_fixed true, duration_seconds 5, generate_audio true i resolution 720p.
Locked-off static wide shot, camera never moves. An adult woman lies on her back across white hotel sheets in a pale blue camisole, ankles crossed and lifted in the foreground, one foot slowly rocking side to side, her hand tracing a lazy circle on the duvet. Blown-out window light, high-key minimal composition, only the sheets and her breathing move.
Blokada jest ustawiona w polu i powtórzona w pierwszym zdaniu promptu. Cały ruch należy do osoby lub do tkaniny.
Tani szkic, potem dostawa
resolution i duration_seconds wyznaczają cenę, a generate_audio podnosi próg. Dopracuj sformułowanie w 480p bez dźwięku, a rozdzielczość i dźwięk podnieś dopiero dla ujęcia, które oddajesz.
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-1.5-pro/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"aspect_ratio": "16:9",
"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.
