Wprowadzenie
Seedance 1.5 Pro w trybie obraz na wideo zaczyna klip od twojego obrazu i animuje go do 12 sekund. Z włączonym camera_fixed kadrowanie zostaje dokładnie takie, jak je skomponowano — dlatego ten endpoint daje użyteczne plany do kompozycji.
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 | Wymagany, i powinien mówić, co dzieje się po klatce, a nie powtarzać to, co już widać: czynność, upływ czasu, dźwięk. od 3 znaków |
image_url | Tak | Publiczny, bezpośrednio pobieralny link do pierwszej klatki; wymagany. |
last_image_url | Nie | Opcjonalna klatka końcowa: wysłana razem z |
aspect_ratio | Nie | Kadrowanie wyjścia, sześć sztywnych wartości, domyślnie 16:9. |
resolution | Nie | Rozdzielczość wyjścia, domyślnie 720p, a najwyżej 1080p; nic wyższego nie jest tu oferowane. Wybiera próg cenowy. |
duration_seconds | Nie | Długość w pełnych sekundach, od 4 do 12, domyślnie 5, i zarazem rozliczana wielkość. |
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. 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
Plany do kompozycji
Wyślij zatwierdzony kadr, włącz camera_fixed, a kompozycja utrzyma się przez cały klip, podczas gdy porusza się tylko postać. Wynik zachowuje się jak materiał ze statywu: czyste tło do kluczowania, stabilna powierzchnia do śledzenia napisu, plan, który montażysta wstawi do prawdziwej sekwencji.
Obroty produktu i pętle
Nieruchomy kadr z obracającym się przedmiotem to klasyka: nic nie dryfuje, horyzont zostaje prosty, a ostatnia klatka ląduje na tyle blisko pierwszej, że da się zrobić pętlę. Wyłącz generate_audio, bo pętla produktowa prawie nigdy nie potrzebuje dźwięku otoczenia.
Powolny ruch otoczenia
Opublikowany przykład nakłada na jeden kadr padający śnieg, unoszącą się parę i wodę, z bardzo powolnym najazdem, żeby nic nie zginęło w tempie kamery. Pogoda, dym i woda to właśnie ruch, który najlepiej wygląda w nieruchomej kompozycji.
Wskazówki
Wyślij oba wymagane pola
Tu wymagane są zarówno prompt, jak i image_url, a prompt musi mieć co najmniej 3 znaki. Obraz musi być publicznym, bezpośrednio pobieralnym plikiem JPEG, PNG lub WebP poniżej 10 MB. Napisy, znaki wodne i logotypy z kadru przechodzą do wideo, więc usuń je wcześniej.
Dopasuj proporcje do kadru
Nie ma opcji adaptacyjnej, a aspect_ratio ma domyślnie 16:9. Gdy wybrane proporcje różnią się od źródła, kadr zostaje przekadrowany i postać może stracić marginesy, więc wybierz proporcje zgodne z twoim zdjęciem.
Dostosuj dołączony przykład
Opublikowany przykład używa aspect_ratio 16:9, duration_seconds 5 i resolution 720p, a dźwięk zostaje na wartości domyślnej.
Snow keeps falling through the lantern light and steam pours off the water. She sets the folded towel robe down on the rock and sinks slowly into the spring up to her collarbone, tipping her head back and exhaling a long plume of breath into the cold air. Steam swells across the frame and snow settles on her wet hair. Very slow push-in, warm lantern gold against deep blue snow.
Latarnie i otoczenie daje kadr; prompt tylko zanurza postać w źródle i każe jej wypuścić powietrze. Zachowaj ten podział, gdy podstawisz własne zdjęcie.
Trzymaj ruch w zablokowanym kadrze
Przy camera_fixed równym true opisuj tylko ruch wewnątrz kadru, bo polecenie dla kamery i zablokowana kamera działają przeciwko sobie. Sprawdź ruch przy 4–5 sekundach, zanim wydłużysz do 12, bo dłuższe ujęcie bardziej oddala się od kadru źródłowego.
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/image-to-video",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"generate_audio": true,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p"
}
}'
# 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.
