ByteDance: Seedance 1.0 Pro Fast
Seedance 1.0 Pro Fast to osobno nazwany profil Fast do niemego generowania tekst-do-wideo i obraz-do-wideo. Przyjmuje opis sceny lub kompozycję kierowaną obrazem, z wyjściem długości 2–12 sekund, 24 fps i jawnymi ustawieniami kadrowania.
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.0 Pro Fast to profil Fast identyfikowany przez doubao-seedance-1-0-pro-fast-251015. Generuje nieme wideo na podstawie opisu sceny lub kompozycji początkowej kierowanej obrazem. Dokładny selektor odróżnia ten profil od Seedance 1.0 Pro; słowo Fast nie określa gwarantowanego czasu ukończenia pojedynczego zadania. Wybierz tryb wejściowy zgodnie z tym, co powinno ustalać scenę, a następnie oceń zwrócony klip względem tego opisu.
Ujęcie kierowane tekstem zaczyna się od zwięzłej sekwencji: obiekt i otoczenie, działanie, trasa kamery i końcowy widok. Dla prezentacji produktu opisz przedmiot na powierzchni, światło na jego materiale i krótki ruch kończący się pokazaniem wybranej cechy. Dla koncepcji lokalizacji przejdź od szerokiego planu ogólnego do rozpoznawalnego punktu skupienia. Unikaj wymagania od jednego krótkiego klipu kilku niepowiązanych scen, których obiekty i otoczenie za każdym razem trzeba wprowadzać od początku.
Ujęcie kierowane obrazem zaczyna się od elementu image_url w tablicy content i tekstowej instrukcji ruchu. Przygotuj w obrazie kadr, tło i układ obiektów, a następnie określ, które elementy się poruszają i jak zachowuje się kamera. Pozwala to przekształcić nieruchomą kompozycję w krótką animowaną scenę. Przydaje się to do portretu, przedmiotu na blacie lub przygotowanej koncepcji wizualnej; rzeczywisty wynik nadal wymaga sprawdzenia tożsamości, kształtu i ruchu przez cały klip.
Obrazy wejściowe mogą korzystać z dostępnego adresu URL lub adresu danych Base64. Udokumentowane formaty to JPEG, PNG, WEBP, BMP, TIFF i GIF; obraz musi być mniejszy niż 30 MB, z oboma wymiarami ściśle między 300 a 6000 pikseli oraz ilorazem szerokości i wysokości ściśle między 0.4 a 2.5. Wybierz czyste źródło z widocznymi szczegółami obiektu. Poradnik dotyczący obrazów zaleca kadrowanie adaptive, więc proporcje przygotowanego źródła powinny odpowiadać kompozycji, którą chcesz ożywić.
Profil 1.0 dokumentuje długość od dwóch do dwunastu sekund przy 24 fps. Pro Fast ma 1080p jako domyślną rozdzielczość, a zachowana tabela wyjścia wymienia poziomy 480p, 720p i 1080p. Poradnik operacji wyklucza 1080p w scenariuszu obrazu referencyjnego. Stałe proporcje obejmują 16:9, 4:3, 1:1, 3:4, 9:16 i 21:9. Wybierz rozdzielczość i kadr odpowiednie do wybranego trybu wejściowego zamiast zakładać, że każda kombinacja jest zamienna.
Opcje ziarna i znaku wodnego pomagają jawnie określić ustawienia żądania. Zakres całkowitoliczbowego ziarna wynosi od -1 do 2^32-1; -1 żąda losowości. Instrukcja nieruchomej kamery jest warunkowa: poradnik wyklucza ją w scenariuszu obrazu referencyjnego i nie gwarantuje efektu wizualnego tam, gdzie jest obsługiwana. Polecenia parametrów osadzone w tekście nadpisują osobne parametry opcjonalne. Zachowaj zgodność tych instrukcji, zwłaszcza gdy poprawiasz prompt, w którego opisie sceny mogło pozostać stare polecenie długości lub rozdzielczości.
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.
Wysłanie żądania tworzy zadanie asynchroniczne. Zapisz jego identyfikator, śledź stan i po sukcesie pobierz ukończone wideo z content.video_url. Wygenerowane pliki są zgodnie z dokumentacją przechowywane przez siedem dni, więc zachowaj ukończony artefakt razem z promptem i ewentualnym obrazem wejściowym. Sprawdź całe działanie, ruch kamery i końcowy kadr; jeśli jeden szczegół odbiega od opisu, sformułuj tę konkretną poprawkę, zachowując udane elementy.
Ailoot Ultra · Wideo POST /v1/videos doubao-seedance-1-0-pro-fast-251015
doubao-seedance-1-0-pro-fast-251015
doubao-seedance-1-0-pro-fast-251015Start
Seedance 1.0 Pro Fast to osobno nazwany profil Fast do niemego generowania tekst-do-wideo i obraz-do-wideo. Przyjmuje opis sceny lub kompozycję kierowaną obrazem, z wyjściem długości 2–12 sekund, 24 fps i jawnymi ustawieniami kadrowania.
- 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-0-pro-fast-251015 | 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 Minimum: 2 Maksimum: 12 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 Warunki: Potwierdzone wartości dla generowania wideo z tekstu to 480p i 1080p. Wejściowy obraz referencyjny wyklucza 1080p. Wspólna wartość enum 720p jest sprzeczna z opisem danego modelu, więc obsługa 720p pozostaje nierozstrzygnięta w obu trybach. | Domyślnie1080p |
Poleratio | Typstring | WymaganieOpcjonalne | Wartości i limity 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive Warunki: Wartości domyślne zależą od sceny i modelu; dokumentacja wejścia obrazowego zaleca adaptive. | Domyślnie— |
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 |
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 |
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ść | Jednostka rozliczeniowa | Opłata |
|---|---|---|---|---|
| KonfiguracjaBazowe stawki za tokeny | Tabela stawekStawka podstawowa | Przewidywana ilość— | 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 |
| KonfiguracjaUltra | Tabela stawek— | Przewidywana ilość— | Jednostka rozliczeniowaza 1K tokenów wideo | Opłata Wyjście · Szacunek tylko do porównania $0.0012 za 1K tokenów wideo |
| KonfiguracjaSzacowany koszt generowania | Tabela stawek— | Przewidywana ilośćszacunek dla jednego generowania | Jednostka rozliczeniowa— | Opłata Wyjście · Szacowany koszt generowania · Szacunek tylko do porównania $0.0576 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-0-pro-fast-251015","content":[{"type":"text","text":"女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动"}],"resolution":"480p","ratio":"1:1","duration":5,"service_tier":"default","seed":-1,"camerafixed":false,"watermark":false,"execution_expires_after":172800}
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-0-pro-fast-251015
Aliasy ścieżek metod
/v1/videos/generations
Powiązane ID modeli
FAQ · ByteDance: Seedance 1.0 Pro Fast
- Jakie dane wejściowe i wyniki są dostępne?
POST /v1/videos·doubao-seedance-1-0-pro-fast-251015:text,image→video- Jakich pól używa żądanie?
POST /v1/videos·doubao-seedance-1-0-pro-fast-251015:model,content,duration,resolution,ratio,service_tier,seed,camerafixed,watermark,execution_expires_after- Jakie limity obowiązują?
POST /v1/videos·doubao-seedance-1-0-pro-fast-251015:duration.minimum:2;duration.maximum:12;seed.minimum:-1;seed.maximum:4294967295;execution_expires_after.minimum:3600;execution_expires_after.maximum:259200