ByteDance: Seedance 1.5 Pro
Seedance 1.5 Pro generuje wideo z tekstu lub obrazu i może tworzyć zsynchronizowane głosy, efekty oraz muzykę tła. Dźwięk można włączyć lub wyłączyć; udokumentowany profil oferuje sceny 4–12 sekund, kadrowanie adaptive oraz przetwarzanie online lub flex.
O modelu
Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.
Seedance 1.5 Pro generuje wideo z tekstu lub obrazu i może tworzyć dźwięk razem z obrazem. Dokładny selektor to doubao-seedance-1-5-pro-251215. Ustawienie dźwięku odróżnia go od niemych profili Seedance 1.0: generate_audio=true żąda zsynchronizowanego dźwięku, natomiast false żąda niemego wideo. Użyj opisu sceny do nowej koncepcji albo obrazu do ustalenia obiektu i kompozycji otwierającej.
Opisz widoczne działanie i dźwięk jako części tej samej sceny. Określ obiekt, otoczenie, ruch i kamerę, a następnie wyjaśnij zamierzone głosy, efekty dźwiękowe lub muzykę tła. Scena portretowa może przedstawiać osobę otwierającą oczy podczas powolnego odjazdu kamery, z wiatrem w otoczeniu. W scenie produktowej powiąż dźwięk z widocznym zdarzeniem, takim jak otwieranie pokrywy lub dotknięcie powierzchni przez przedmiot, zamiast dodawać niepowiązaną listę efektów.
Model może generować głosy, efekty i muzykę tła na podstawie promptu i zawartości wizualnej. Poradnik zaleca umieszczanie wypowiadanych kwestii w podwójnym cudzysłowie. Dopasuj długość mowy do żądanego działania i przerw oraz rozróżnij mówiących, gdy występuje więcej niż jedna postać. Sprawdź rzeczywiste słowa, przypisanie głosu i synchronizację z obrazem. Instrukcja dźwiękowa kieruje generowanym wykonaniem; nie jest osobnym wejściem z przesłanym wzorcem głosu w udokumentowanym żądaniu tego profilu.
Generowanie obraz-do-wideo korzysta z elementu image_url obok tekstu. Dostarcz dostępny adres URL obrazu lub adres danych Base64 w formacie JPEG, PNG, WEBP, BMP, TIFF lub GIF. Udokumentowane limity obrazu to rozmiar poniżej 30 MB, oba wymiary ściśle między 300 a 6000 pikseli i iloraz szerokości oraz wysokości ściśle między 0.4 a 2.5. Wyraźnie przygotuj zamierzony kadr i obiekt, a następnie opisz ruch z tej kompozycji. Przykład obrazowy korzysta z proporcji adaptive, aby podążać za odniesieniem.
Poradnik długości dla tego profilu wymienia pełne sekundy od czterech do dwunastu lub -1, aby model wybrał długość w tym zakresie. Domyślna długość wynosi pięć sekund. Seedance 1.5 Pro domyślnie korzysta z 720p, a zachowana tabela profilu dokumentuje 480p i 720p; dedykowany poradnik operacji nie oferuje 1080p dla 1.5 Pro. Stałe proporcje obejmują 16:9, 4:3, 1:1, 3:4, 9:16 i 21:9, z adaptive jako udokumentowaną wartością domyślną 1.5. Sprawdź rzeczywistą długość i proporcje klipu zamiast traktować żądane wartości jako już zwrócony artefakt.
Żądanie udostępnia dwa poziomy przetwarzania. service_tier=default wybiera przetwarzanie online, natomiast flex wybiera przetwarzanie offline dla pracy tolerującej dłuższe oczekiwanie. Poziomu nie można zmienić po wysłaniu zadania. Wybierz go zgodnie z potrzebami czasowymi przepływu i zachowaj ten wybór w zapisie żądania. Tryb dźwięku i poziom przetwarzania to odrębne wybory: niemy klip nie staje się automatycznie zadaniem offline, a włączenie dźwięku nie wybiera poziomu przetwarzania.
Zachowaj zgodność instrukcji ziarna, znaku wodnego i kamery ze sceną. Polecenia parametrów osadzone w tekście mają pierwszeństwo przed osobnymi parametrami opcjonalnymi. Ustawienie nieruchomej kamery jest wykluczone w scenariuszu obrazu referencyjnego i nie gwarantuje blokady obrazu tam, gdzie działa. Dla animacji kierowanej obrazem wyjaśnij zamierzony ruch bezpośrednio zamiast zakładać, że ustawienie kamery usuwa potrzebę opisania ujęcia.
Zużycie jest mierzone w tokenach wideo: szerokość wyjściowa × wysokość wyjściowa × liczba klatek na sekundę × długość wyjściowego klipu / 1024. Zakończone zadanie raportuje tę wielkość jako usage.completion_tokens. Zachowaj zgłoszone zużycie razem z gotowym klipem i żądanymi ustawieniami. Włączenie lub wyłączenie dźwięku oraz przetwarzanie online lub flex pozostają odrębnymi kategoriami w opłacie opartej na zużyciu.
Wysłanie żądania zwraca identyfikator zadania asynchronicznego. Śledź zadanie do zakończenia, a następnie zapisz wideo dostarczone w content.video_url. Udokumentowany okres przechowywania wygenerowanych plików wynosi siedem dni. Ustawienie wygaśnięcia jest liczone od utworzenia, domyślnie wynosi 172800 sekund i przyjmuje wartości od 3600 do 259200 sekund; niedokończone zadanie po upływie skonfigurowanego czasu otrzymuje stan expired. Zachowaj końcowy klip, oryginalny obraz i dokładny opis obrazu oraz dźwięku razem, a następnie sprawdź cały wynik pod kątem działania, tożsamości, ciągłości kamery i zgodności dźwięku.
Ailoot Ultra · Wideo POST /v1/videos doubao-seedance-1-5-pro-251215
doubao-seedance-1-5-pro-251215
doubao-seedance-1-5-pro-251215Start
Seedance 1.5 Pro generuje wideo z tekstu lub obrazu i może tworzyć zsynchronizowane głosy, efekty oraz muzykę tła. Dźwięk można włączyć lub wyłączyć; udokumentowany profil oferuje sceny 4–12 sekund, kadrowanie adaptive oraz przetwarzanie online lub flex.
- Akceptowane dane wejściowe
- Tekst · Obrazy
- Wyniki
- Wideo
Dostępne w Ailoot · dane wejściowe i metody
Ailoot Ultra · Wideo POST /v1/videos
- Wejście
text,image- Wyjście
video
| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity doubao-seedance-1-5-pro-251215 | Domyślnie— |
Polecontent | Typarray | WymaganieWymagane | Wartości i limity Warunki: Natywne obiekty tekstowe i multimedialne; zewnętrzna tablica musi być niepusta. Ten ogólny konstruktor Ailoot nie weryfikuje typów zagnieżdżonych węzłów. | Domyślnie— |
Poleduration | Typinteger | WymaganieOpcjonalne | Wartości i limity Warunki: Pierwotny schemat 1.x określa 2–12; późniejszy wspólny opis wskazuje dla 1.5 zakres 4–12 lub -1. Przykład używa wartości 5 udokumentowanej w obu miejscach. | Domyślnie5 |
Poleresolution | Typstring | WymaganieOpcjonalne | Wartości i limity 480p, 720p Warunki: Seedance 1.5 Pro obsługuje 480p i 720p; 1080p jest wykluczone. Udokumentowana domyślna rozdzielczość to 720p. | Domyślnie720p |
Poleratio | Typstring | WymaganieOpcjonalne | Wartości i limity 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive Warunki: Udokumentowaną domyślną wartością proporcji dla Seedance 1.5 Pro jest adaptive. Dostępne stałe proporcje pozostają bez zmian. | Domyślnieadaptive |
Poleservice_tier | Typstring | WymaganieOpcjonalne | Wartości i limity default, flex Warunki: default=online, flex=offline; wybierz przed utworzeniem. | Domyślniedefault |
Poleseed | Typinteger | WymaganieWymagane | Wartości i limity Minimum: -1 Maksimum: 4 294 967 295 | Domyślnie-1 |
Polecamerafixed | Typboolean | WymaganieWymagane | Wartości i limity Warunki: Wymagane przez Ailoot; sterowanie kamerą przy obrazie referencyjnym jest opisane jako nieobsługiwane, a jego efekt nie jest gwarantowany. | Domyślniefalse |
Polewatermark | Typboolean | WymaganieWymagane | Wartości i limity | Domyślniefalse |
Poleexecution_expires_after | Typinteger | WymaganieWymagane | Wartości i limity Minimum: 3600 Maksimum: 259 200 Jednostka: sekundy | Domyślnie172 800 |
Polegenerate_audio | Typboolean | WymaganieOpcjonalne | Wartości i limity Warunki: Zsynchronizowany dźwięk osadzony w wygenerowanym wideo, wyłącznie dla 1.5. | Domyślnietrue |
Kombinacje materiałów wejściowych
Parametry i cykl życia metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktcamerafixed, content, execution_expires_after, model, seed, watermark |
Parametroptional | Kontraktduration, resolution, ratio, service_tier, generate_audio |
Parametrmaterial_types | Kontrakttext, image |
Parametradditional_properties | Kontrakttrue |
Parametrvalidation_scope | KontraktAiloot sprawdza wymagane typy pól oraz niepusty model i tablicę content. Pozostałe pola żądania są zachowywane dla wybranego modelu. |
Parametrimage_constraints | Kontrakt{"formats":["jpeg","png","webp","bmp","tiff","gif"],"aspect_ratio_exclusive":[0.4,2.5],"dimensions_px_exclusive":[300,6000],"file_size_mb_exclusive":30,"mb_bytes_definition":null} |
Aliasy metody: /v1/videos/generations
Cykl życia: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Utwórz raz i zachowaj zwrócone publiczne id/polling_url.
Odpytuj pierwotne zadanie; pobierz rzeczywistą treść content.video_url należącą do użytkownika po uzyskaniu succeeded.
Cennik
Jak obliczana jest ostateczna opłata
Wyświetlane stawki służą do oszacowania kosztu przed generowaniem. Ostateczna opłata jest obliczana na podstawie kosztu zarejestrowanego dla pierwotnego generowania. Zmierzony czas trwania wyniku i prognozowane ilości nie stanowią ostatecznej ilości podlegającej rozliczeniu.
Informacje taryfowe nie dodają opcji żądania. Obsługiwane parametry podano przy wybranej metodzie.
- Tryb szybki
- Nie określono Gdy wybrany jest tryb szybki
- Tryb flex
- Nie określono Gdy wybrany jest tryb flex
- Maksymalna intensywność rozumowania
- Nie określono Gdy dla maksymalnej intensywności rozumowania stosowana jest domyślna korekta (default)
Szacunkowe stawki do porównania
Ceny według konfiguracji
Dopasuj każdą opłatę do pokazanych warunków. Użyj jednej stawki dla każdego zestawu alternatywnych konfiguracji.
| Konfiguracja | Tabela stawek | Przewidywana ilość | Generuj dźwięk | Poziom usługi | Jednostka rozliczeniowa | Opłata |
|---|---|---|---|---|---|---|
| KonfiguracjaBazowe stawki za tokeny | Tabela stawekStawka podstawowa | Przewidywana ilość— | Generuj dźwięk— | Poziom usługi— | Jednostka rozliczeniowa— | Opłata Wejście · Tokeny wejściowe · Szacunek tylko do porównania — / 1K tokenów Wyjście · Tokeny wyjściowe · Szacunek tylko do porównania — / 1K tokenów Wejście · Odczyt cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache, 1 godz. · Szacunek tylko do porównania — / 1K tokenów |
| KonfiguracjaPoziom usługi z przetwarzaniem offline (flex). Wynik ze zsynchronizowanym dźwiękiem. | Tabela stawek— | Przewidywana ilość— | Generuj dźwiękZ dźwiękiem | Poziom usługiflex | Jednostka rozliczeniowaza 1K tokenów wideo | Opłata Wyjście · Szacunek tylko do porównania $0.0024 za 1K tokenów wideo |
| KonfiguracjaPoziom usługi z przetwarzaniem offline (flex). Wynik bez zsynchronizowanego dźwięku. | Tabela stawek— | Przewidywana ilość— | Generuj dźwiękBez dźwięku | Poziom usługiflex | Jednostka rozliczeniowaza 1K tokenów wideo | Opłata Wyjście · Szacunek tylko do porównania $0.0012 za 1K tokenów wideo |
| KonfiguracjaPoziom usługi z przetwarzaniem online (default). Wynik ze zsynchronizowanym dźwiękiem. | Tabela stawek— | Przewidywana ilość— | Generuj dźwiękZ dźwiękiem | Poziom usługidefault | Jednostka rozliczeniowaza 1K tokenów wideo | Opłata Wyjście · Szacunek tylko do porównania $0.0048 za 1K tokenów wideo |
| KonfiguracjaPoziom usługi z przetwarzaniem online (default). Wynik bez zsynchronizowanego dźwięku. | Tabela stawek— | Przewidywana ilość— | Generuj dźwiękBez dźwięku | Poziom usługidefault | Jednostka rozliczeniowaza 1K tokenów wideo | Opłata Wyjście · Szacunek tylko do porównania $0.0024 za 1K tokenów wideo |
| KonfiguracjaSzacowany koszt generowania | Tabela stawek— | Przewidywana ilośćszacunek dla jednego generowania | Generuj dźwięk— | Poziom usługi— | Jednostka rozliczeniowa— | Opłata Wyjście · Szacowany koszt generowania · Szacunek tylko do porównania $0.1152 szacunek przed generowaniem Ten szacunek nie jest dodatkową opłatą ani stałą stawką za ukończone generowanie. |
Ailoot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →
Przykładowe żądania
Ailoot Ultra · Wideo
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"doubao-seedance-1-5-pro-251215","content":[{"type":"text","text":"女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动"}],"resolution":"480p","ratio":"1:1","duration":5,"service_tier":"default","seed":-1,"camerafixed":false,"watermark":false,"execution_expires_after":172800,"generate_audio":false}
JSON_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_POLL'
import json
from pathlib import Path
from urllib.parse import quote,urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
i=r.get("id")
if not isinstance(i,str) or not i.startswith("native302_"):raise SystemExit("Keep original response/headers/id; do not resubmit creation.")
u=urljoin("https://api.ailoot.ai",r.get("polling_url") or "/v1/videos/"+quote(i,safe=""))
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/videos/"):raise SystemExit("Use actual Ailoot lookup path.")
Path("poll-url.txt").write_text(u)
PY_POLL
curl --fail-with-body --silent --show-error "$(cat poll-url.txt)" -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
set -eu
python3 - <<'PY_ASSETS'
import json
from pathlib import Path
from urllib.parse import urlsplit
r=json.loads(Path("status.json").read_text())
if r.get("status")!="succeeded":raise SystemExit("Poll same original job until an owned result is returned.")
u=r.get("content",{}).get("video_url")
urls=[u] if isinstance(u,str) else u
if not isinstance(urls,list) or not urls:raise SystemExit("No completed video URL.")
for u in urls:
if not isinstance(u,str):raise SystemExit("Invalid returned URL.")
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/media/assets/") or not p.path.endswith("/content") or not p.query:raise SystemExit("Wait for actual Ailoot-owned signed result.")
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_ASSETS
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" -o "video-${index}.bin"
index=$((index + 1))
done < asset-urls.txt
Odbieranie i zapisywanie wyników
Ailoot Ultra · Wideo
Natywny JSON z publicznym id/polling_url. Po publikacji content.video_url zawiera podpisane adresy URL należące do Ailoot; przed publikacją wybrane adresy URL wyników są puste.
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Zachowaj wszystkie ukończone wyniki
Zapisz każde ukończone wideo lub zwrócony plik; pobierz każdy faktycznie zwrócony URL zasobu.
Zachowaj każdy rzeczywisty URL z content.video_url; index musi wskazywać faktycznie zwrócony wynik.
Jeśli trzeba sprawdzić pierwotną odpowiedź
Zachowaj oryginalną odpowiedź, nagłówki i id oraz odpytuj tę operację; nigdy nie ponawiaj żądania utworzenia o nieznanym wyniku.
Pola odpowiedzi
| Pole | Typ |
|---|---|
Poleid | Typstring |
Poleprovider_task_id | Typstring |
Polepolling_url | Typstring |
Polestatus | Typstring when supplied |
Polecontent.video_url | Typstring|string[] |
Poleusage | Typobject when supplied |
Błędy i dalsze kroki
| Odpowiedź | Warunek | Następny krok |
|---|---|---|
Odpowiedź400 · invalid_request_error | WarunekNieprawidłowy JSON/model, typy wymaganych pól lub indeks treści. | Następny krok |
Odpowiedź401 · authentication_error | WarunekNieprawidłowy klucz API Ailoot. | Następny krok |
Odpowiedź404 · not_found_error | WarunekZadanie lub wynik nie istnieje albo nie należy do tego samego użytkownika, klucza API lub grupy. | Następny krok |
Odpowiedź502 · result_pending_check | WarunekPierwotne wysłanie lub sprawdzenie statusu jest niekompletne; zachowaj pierwotny identyfikator i nie wysyłaj ponownie. | Następny krok |
Odpowiedź503 · result_pending_check | WarunekPierwotne multimedia, ścieżka lub rozliczenie są sprawdzane; kontynuuj pierwotną operację. | Następny krok |
Aliasy
Aliasy modelu
Ailoot Ultra doubao-seedance-1-5-pro-251215
Aliasy ścieżek metod
/v1/videos/generations
Powiązane ID modeli
FAQ · ByteDance: Seedance 1.5 Pro
- Jakie dane wejściowe i wyniki są dostępne?
POST /v1/videos·doubao-seedance-1-5-pro-251215:text,image→video- Jakich pól używa żądanie?
POST /v1/videos·doubao-seedance-1-5-pro-251215:model,content,duration,resolution,ratio,service_tier,seed,camerafixed,watermark,execution_expires_after,generate_audio- Jakie limity obowiązują?
POST /v1/videos·doubao-seedance-1-5-pro-251215:seed.minimum:-1;seed.maximum:4294967295;execution_expires_after.minimum:3600;execution_expires_after.maximum:259200