Seedance 2.5 Flash

Generuj filmy o długości 4–30 sekund w 480p lub 720p na podstawie tekstu, pierwszej/ostatniej klatki lub multimodalnych materiałów referencyjnych albo edytuj jeden film źródłowy.

Seedance 2.5 Flash obsługuje generowanie filmów z tekstu, generowanie z pierwszej/ostatniej klatki, generowanie z materiałów referencyjnych i edycję filmów. Użyj dreamina-seedance-2-5-flash w wariancie Default. Przesyłaj multimedia jako publiczne adresy URL HTTP lub HTTPS bez danych uwierzytelniających. Zapisz zwrócony identyfikator zadania i odpytuj zadanie, aby uzyskać gotowy film.

Zobacz playground i aktualne ceny, specyfikację OpenAPI oraz przewodnik po cenach.

Szybki przykład

To żądanie tworzy czterosekundowy film. Przed jego wysłaniem sprawdź aktualną cenę; zlecenie udanego generowania wiąże się z opłatą.

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-5-flash",
    "content": [{"type": "text", "text": "A ceramic cup slowly rotates under warm studio lighting."}],
    "resolution": "480p",
    "duration": 4,
    "ratio": "16:9",
    "generate_audio": false
  }'

Parametry

model i content są wymagane. Wszystkie pozostałe pola są opcjonalne. Jawne wartości null i nieznane pola są odrzucane.

Pole	Typ	Wartość domyślna	Ograniczenia
`model`	ciąg znaków	wymagane	`dreamina-seedance-2-5-flash`
`content`	tablica	wymagane	Co najmniej jeden niepusty element tekstowy; elementy multimedialne wymagają roli.
`resolution`	ciąg znaków	`720p`	`480p` lub `720p`.
`duration`	liczba całkowita	`5` lub `-1` przy edycji	Generowanie: 4–30 sekund. Edycja: pomiń lub użyj `-1`; wynik zachowuje długość źródła.
`ratio`	ciąg znaków	`16:9` lub `adaptive` dla klatek/edycji	Generowanie z tekstu/materiałów referencyjnych: `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `21:9`. Pierwsza/ostatnia klatka i edycja: tylko `adaptive`.
`generate_audio`	wartość logiczna	`true`	Włącz lub wyłącz generowany dźwięk; nie zmienia to stawki.
`omni_reference_task_type`	ciąg znaków	`generate`	`generate` lub `edit`. Edycja wymaga dokładnie jednego filmu.
`content_filter`	wartość logiczna	`true`	Akceptowana jest tylko wartość `true`; w playgroundzie nie jest potrzebna kontrolka.

Dokumentacja określa maksymalną długość promptów na 10 000 tokenów. Nie wskazano publicznego tokenizera, więc liczby znaków nie wolno traktować jako dokładnej liczby tokenów.

Treść i tryby

Tekst używa {"type":"text","text":"Describe the shot"}. Obrazy, filmy i dźwięk używają zagnieżdżonego adresu URL i jawnej roli:

{
  "type": "image_url",
  "image_url": {"url": "https://example.com/reference.jpg"},
  "role": "reference_image"
}

Tryb	Treść	Kadrowanie i długość
Film z tekstu	Tylko tekst	Stałe proporcje; 4–30 sekund.
Pierwsza/ostatnia klatka	Tekst i jeden obraz `first_frame`, opcjonalnie jeden obraz `last_frame`	`adaptive`; 4–30 sekund. Ostatnia klatka wymaga pierwszej klatki.
Generowanie z materiałów referencyjnych	Tekst i elementy `reference_image`, `reference_video` lub `reference_audio`	Stałe proporcje; 4–30 sekund. Do 10 obrazów, 5 filmów i 5 nagrań dźwiękowych.
Edycja filmu	Tekst, dokładnie jeden `reference_video`, opcjonalne obrazy/nagrania dźwiękowe jako materiały referencyjne; typ zadania `edit`	`adaptive`; długość pominięta lub `-1`.

Elementy wideo używają type: "video_url", video_url: {"url": "..."}, role: "reference_video"; elementy dźwiękowe używają audio_url i reference_audio w tej samej strukturze. Pierwszej/ostatniej klatki nie można łączyć z multimedialnymi materiałami referencyjnymi. W tej integracji nie są dostępne kontrolki Draft, Extend, 1080p, znaku wodnego, ziarna losowości ani zwracania ostatniej klatki. Wywołania zwrotne nie są oferowane.

Ograniczenia multimediów

Multimedia	Formaty	Rozmiar i długość
Obraz	JPEG, PNG, WebP	Do 30 MB; każdy bok 300–6000 px; stosunek szerokości do wysokości 0,4–2,5.
Film	MP4, MOV	Do 200 MB; 24–60 FPS; każdy bok 300–6000 px; proporcje 0,4–2,5; 409 600–8 295 044 pikseli. Materiały referencyjne: po 2–30 sekund, łącznie najwyżej 30 sekund. Źródło do edycji: 4–30 sekund.
Dźwięk	WAV, MP3	Do 15 MB; po 2–30 sekund, łącznie najwyżej 30 sekund.

Pliki muszą być dostępne do odczytu przed wysłaniem żądania. Do obliczenia opłaty długość filmu jest mierzona na podstawie multimediów. Używaj stabilnych publicznych adresów URL.

Odpowiedź zadania i odpytywanie

Utworzenie zadania zwraca id, model, status i created_at. Odpytuj to samo zadanie aż do jego zakończenia:

curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Status to processing, completed lub failed. Po sukcesie odczytaj output.video_url, aby uzyskać zapisany film. W razie niepowodzenia odczytaj error.code i error.message. Publiczne odpowiedzi nie zawierają kosztów. Przekroczenie limitu czasu odpytywania nie dowodzi niepowodzenia generowania: zachowaj identyfikator zadania i odpytaj je ponownie zamiast zlecać kolejne generowanie.

Rozliczenia

Aktualna stawka zależy od rozdzielczości i od tego, czy przesyłasz film. Bez wejściowego filmu liczba rozliczanych sekund jest równa długości wyniku. W przypadku filmów referencyjnych liczba rozliczanych sekund jest równa długości wyniku powiększonej o większą z dwóch wartości: długość wyniku lub łączną długość materiałów wejściowych zaokrągloną w górę. Przy edycji rozliczana jest podwójna długość źródła zaokrąglona w górę. Dźwięk jest wliczony. Za nieudane żądania nie są pobierane opłaty.

Na przykład pięciosekundowy wynik z trzema sekundami filmu referencyjnego oznacza rozliczenie dziesięciu sekund. Edycja dziesięciosekundowego źródła oznacza rozliczenie dwudziestu sekund. Pomnóż liczbę rozliczanych sekund przez odpowiednią aktualną stawkę.

Zobacz cykl życia zadania i kody błędów, aby poznać typowe odpowiedzi i wskazówki dotyczące ponawiania prób.