Przejdź do dokumentacji
Na tej stronie

Seedance 2.5 Flash

Generuj wideo za pomocą modelu Seedance 2.5 Flash, używając tekstu, pierwszej i ostatniej klatki lub referencji multimodalnych. Ta strona opisuje pełny proces od wysłania żądania do otrzymania gotowego wyniku.

ID modelu w API: seedance-2-5-flash

Generowanie odbywa się asynchronicznie. Zapisz identyfikator taskId zwrócony przy tworzeniu zadania, a następnie odpytuj o jego status lub odbierz webhook.

Możliwości

Model Seedance 2.5 Flash obsługuje rozdzielczości 480p i 720p, przy czym 720p jest wartością domyślną. Nie obsługuje rozdzielczości 1080p, 4k, podglądów Draft ani finalizacji Draft.
FunkcjaObsługiwane wartości
Rozdzielczość wyjściowa480p · 720p
Czas trwania wyniku4–30 s
Proporcje obrazu16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive
Obrazy referencyjneMaksymalnie 30 zdjęć
Wideo referencyjneMaksymalnie 10 filmów
Pliki audio referencyjneMaksymalnie 10 plików dźwiękowych
Suma wszystkich plików referencyjnychŁącznie maksymalnie 50 plików referencyjnych
Łączny czas trwania na grupę wideo/audioSekundy: 30
seed-1 do 2147483647
W trybie referencji do wideo dopuszczalna jest również wartość duration=-1; szczegóły dotyczące edycji wideo i cennika znajdziesz poniżej. Tryb image-to-video akceptuje wyłącznie wartość adaptive; pomiń to pole lub ustaw je na adaptive.

Cennik i kredyty

Generowanie wideo jest rozliczane w kredytach na podstawie naliczanego czasu trwania w sekundach. Bez wejściowego pliku wideo naliczany czas trwania odpowiada długości wygenerowanego materiału; w przypadku korzystania z wejściowego pliku wideo uwzględnia się również czas trwania wideo referencyjnego.

Poniższa tabela przedstawia liczbę kredytów pobieranych za sekundę, a nie całkowity koszt zadania. Stawka zależy od modelu, rozdzielczości wyjściowej oraz tego, czy w trybie referencyjnym (reference-to-video) dostarczono wideo referencyjne. Wzory i przykłady obliczania całkowitego kosztu znajdują się pod tabelą.

Rozdzielczość wyjściowaBez wejściowego wideoZ wejściowym wideo
480p7 kredytów/sekundę5 kredytów/sekundę
720p10 kredytów/sekundę7 kredytów/sekundę
  • Bez wejściowego wideo: sekundy wyjściowe × stawka bez wideo.
  • Z wejściowym wideo: (sekundy wyjściowe + zmierzony czas trwania wejściowego wideo) × stawka z wideo. Serwer mierzy łączny czas trwania referencyjnego materiału wideo i przed naliczeniem opłaty zaokrągla go w górę do pełnych sekund.
  • Użycie samych obrazów lub plików audio jako referencji rozliczane jest według stawki bez wideo. Stawka dla referencji wideo ma zastosowanie wyłącznie w trybie referencyjnym (reference-to-video), gdy dostarczono pliki wideo.

Przykłady obliczania kosztów

5-sekundowe wideo 720p z tekstu (text-to-video): 5 × 10 = 50 kredytów.

5-sekundowy wynik 720p z 5-sekundowym wideo referencyjnym: (5 + 5) × 7 = 70 kredytów.

Kredyty te są pobierane z góry w momencie utworzenia zadania. Jeśli zadanie zakończy się pomyślnie, kwota ta stanowi ostateczną opłatę – nie zostanie ona zwiększona ani częściowo zwrócona na podstawie rzeczywistego czasu trwania wygenerowanego pliku. W przypadku zadań nieudanych lub przekroczenia limitu czasu następuje automatyczny zwrot środków.

Kredyty są rezerwowane w momencie przesłania zadania i pobierane po jego pomyślnym zakończeniu. Zadania zakończone błędem lub przerwane z powodu limitu czasu trafiają do procesu zwrotu. Status rozliczenia refund_failed oznacza, że zwrot nie został sfinalizowany – sprawdź wtedy logi API lub skontaktuj się ze wsparciem.

Jak naliczane są kredyty, gdy duration=-1

Gdy czas trwania jest ustawiony na -1, końcowa długość wyjściowa nie jest stała i decyduje o niej model.

W większości przypadków zaleca się ustawienie konkretnego czasu trwania wideo zamiast wartości -1. Użycie wartości -1 rekomendujemy wyłącznie do edycji wideo, a nie do innych zastosowań związanych z generowaniem wideo.

Materiały referencyjneSposób obliczania opłatyPrzykład
Z wideo referencyjnymZsumuj czas trwania wszystkich filmów referencyjnych i zaokrąglij wynik w górę do pełnej sekundy – oznaczmy go jako T. Opłata wynosi (T + T) × stawka dla wideo: jedno T odpowiada szacowanemu czasowi trwania wyjściowego wideo, a drugie czasowi trwania wejściowego wideo referencyjnego.720p z 5-sekundowym wideo referencyjnym: (5 + 5) × 7 = 70 kredytów.
Bez wideo referencyjnego (tylko obrazy lub dźwięk)Jako szacowany czas trwania wyjściowego wideo przyjmuje się 30 sekund. Opłata wynosi 30 × stawka bez wideo.720p bez wideo referencyjnego: 30 × 10 = 300 kredytów.

Uwierzytelnianie

Utwórz klucz API w panelu użytkownika. Pełny klucz zostanie wyświetlony tylko raz. Przechowuj go bezpiecznie na swoim serwerze i przesyłaj w nagłówku jako token Bearer przy każdym żądaniu.

Bazowy adres URL

https://api.seevio.ai
Authorization: Bearer sk_live_your_api_key
Content-Type: application/json

Przed uruchomieniem poniższych przykładów ustaw zmienną środowiskową SEEVIO_API_KEY. Przykłady w JavaScript należy uruchamiać na serwerze przy użyciu Node.js; przykłady w Pythonie korzystają z pakietu requests.

Szybki start

Wyślij to proste żądanie, zapisz zwrócony identyfikator taskId, a następnie użyj poniższego przykładu odpytywania o stan zadania. Liczba kredytów w odpowiedzi na utworzenie zadania to kwota zarezerwowana.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'

Przykładowa odpowiedź na utworzenie zadania

Po zaakceptowaniu powyższego żądania interfejs API zwraca tę odpowiedź JSON. taskId to identyfikator zadania służący do późniejszego sprawdzania jego statusu, a credits określa liczbę kredytów zarezerwowanych na poczet tego zadania. Ta odpowiedź potwierdza jedynie utworzenie zadania, a nie gotowość wideo. Aby otrzymać gotowy plik wideo, należy odpytywać API o status zadania lub skorzystać z Webhooka.

{
  "taskId": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "credits": 50
}

Utwórz zadanie

POST https://api.seevio.ai/v1/videos/generations

Wyślij obiekt JSON zawierający model i dane wejściowe (input) oraz opcjonalnie adres callback_url. Zawsze podawaj identyfikator modelu widoczny na tej stronie – w przypadku jego braku domyślnie wybierany jest model seedance-2-0.

Treść żądania

PoleTypWymaganeOpis i ograniczenia
model
stringTak

Identyfikator modelu. Aby użyć modelu Seedance 2.5 Flash, ustaw w tym polu wartość seedance-2-5-flash.

callback_url
stringNie

Publiczny punkt końcowy HTTPS dla wywołań zwrotnych POST po zakończeniu lub błędzie zadania. Sieci prywatne i localhost nie są obsługiwane.

Przykład: https://example.com/webhooks/seevio
input
objectTak

Ustawienia generowania. Pole musi zawierać niepusty prompt.

Parametry wejściowe

Pole image_urls jest wymagane w trybie image-to-video. Tryb reference-to-video wymaga co najmniej jednej referencji w polach image_urls, video_urls lub audio_urls.

Podaj wartości image_urls, video_urls i audio_urls jako tablice ciągów znaków URL (string[]). Każdy podany adres URL musi być publicznie dostępny przez protokół HTTPS, w tym również multimedia ignorowane przez wybrany tryb.

PoleTypWymaganeDomyślnieOpis i ograniczenia
input.prompt
stringTak—

Prompt jest wymagany w każdym trybie. Może składać się z maksymalnie 10000 znaków (przed skróceniem) i nie może zawierać samych białych znaków.

Przykład: A cat surfing at sunset
input.generation_type
stringNietext-to-video
Obsługiwane wartości
text-to-video | image-to-video | reference-to-video

text-to-video, image-to-video lub reference-to-video. W przypadku pominięcia domyślnie ustawiane jest text-to-video i używany jest wyłącznie prompt. Tryb image-to-video używa 1–2 uporządkowanych klatek obrazu. Tryb reference-to-video używa obrazów, filmów i/lub audio; odniesienia zawierające wyłącznie audio są obsługiwane z wymaganym promptem.

input.image_urls
string[]Warunkowo[]

Podaj adresy URL obrazów, które mają określić wygląd. W trybie image-to-video podaj 1 obraz dla pierwszej klatki lub 2 w kolejności: pierwsza klatka, ostatnia klatka. W trybie reference-to-video podaj maksymalnie 30 obrazów. Każdy obraz musi być mniejszy niż 30 MB; wymagania dotyczące formatów i wymiarów znajdziesz w sekcji wymagań dla mediów poniżej. Wszystkie typy odniesień łącznie mogą zawierać maksymalnie 50 plików. W przypadku pominięcia domyślną wartością jest []; parametr ignorowany w trybie text-to-video.

Przykład: ["https://example.com/first-frame.jpg"]
input.video_urls
string[]Warunkowo[]

Podaj adresy URL filmów referencyjnych, aby ukierunkować ruch, edytować lub przedłużyć wideo (tylko w trybie reference-to-video). Maksymalnie 10 plików, każdy do 100 MB i o długości 2–30 sekund; ich łączny czas trwania nie może przekraczać 30 sekund. Wszystkie typy odniesień łącznie mogą zawierać maksymalnie 50 plików. Serwer mierzy czas trwania wideo na potrzeby rozliczenia. W przypadku pominięcia domyślną wartością jest []; parametr ignorowany w innych trybach.

Przykład: ["https://example.com/source.mp4"]
input.audio_urls
string[]Warunkowo[]

Podaj adresy URL plików audio referencyjnych, aby ukierunkować dźwięk (tylko w trybie reference-to-video). Maksymalnie 10 plików MP3/WAV, każdy do 15 MB i o długości 2–30 sekund; ich łączny czas trwania nie może przekraczać 30 sekund. Wszystkie typy odniesień łącznie mogą zawierać maksymalnie 50 plików. Audio może być jedynym typem odniesienia; prompt pozostaje wymagany. W przypadku pominięcia domyślną wartością jest []; parametr ignorowany w innych trybach.

Przykład: ["https://example.com/music.mp3"]
input.duration
integerNie5
Obsługiwane wartości
-1 | 4–30

Czas trwania wygenerowanego wideo jako liczba całkowita od 4 do 30 sekund. Akceptuje również wartość -1 (wyłącznie w trybie reference-to-video). Używaj jej z wideo źródłowym do edycji; rozliczenie następuje według powyższych zasad specjalnych.

Przykład: 5
input.aspect_ratio
stringNieadaptive
Obsługiwane wartości
16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive

16:9, 4:3, 1:1, 3:4, 9:16, 21:9 lub adaptive. W przypadku pominięcia domyślnie przyjmuje wartość adaptive, co pozwala modelowi samodzielnie określić proporcje wyjściowe. Dla edycji lub przedłużania wideo użyj adaptive. Tryb image-to-video akceptuje wyłącznie wartość adaptive; pomiń to pole lub ustaw je na adaptive.

Przykład: adaptive
input.resolution
stringNie720p
Obsługiwane wartości
480p | 720p

480p lub 720p. W przypadku pominięcia domyślnie przyjmowana jest rozdzielczość 720p we wszystkich obsługiwanych trybach generowania. Wyższe rozdzielczości są odrzucane.

Przykład: 720p
input.generate_audio
booleanNietrue
Obsługiwane wartości
true | false

Wartość true żąda zsynchronizowanego dźwięku; false wyłącza generowanie dźwięku. W przypadku pominięcia domyślnie przyjmuje wartość true. Dotyczy wszystkich obsługiwanych trybów generowania.

Przykład: true
input.watermark
booleanNiefalse
Obsługiwane wartości
true | false

Wartość true żąda dodania znaku wodnego AI do wideo wyjściowego; false żąda wideo bez tego znaku wodnego. W przypadku pominięcia domyślnie przyjmuje wartość false. Dotyczy wszystkich obsługiwanych trybów generowania.

Przykład: false
input.web_search
booleanNiefalse
Obsługiwane wartości
true | false

Wartość true zezwala na przeszukiwanie sieci, jeśli jest ono dostępne dla modelu; false wyłącza tę opcję. W przypadku pominięcia domyślnie przyjmuje wartość false. Włączenie tej opcji nie gwarantuje, że wyszukiwanie zostanie przeprowadzone.

Przykład: false
input.return_last_frame
booleanNiefalse
Obsługiwane wartości
true | false

Wartość true żąda zwrócenia ostatniej klatki wygenerowanego filmu; false wyłącza to żądanie. W przypadku pominięcia domyślnie przyjmuje wartość false. Dotyczy wszystkich obsługiwanych trybów generowania. Gdy zażądano klatki i jest ona dostępna, jej adres URL jest zwracany jako data.last_frame_url; w przeciwnym razie wynosi null.

Przykład: true
input.seed
integerNie—
Obsługiwane wartości
-1 do 2147483647

Liczba całkowita z zakresu od -1 do 2147483647. Wartość -1 wybiera losowe ziarno.

Przykład: 42
input.output_format
stringNiemp4
Obsługiwane wartości
mp4 | mov

mp4 lub mov. W przypadku pominięcia domyślnie przyjmuje wartość mp4. Określa format kontenera wyjściowego we wszystkich obsługiwanych trybach generowania.

Pola logiczne (boolean) muszą mieć wartość true lub false w formacie JSON (nie jako ciąg znaków czy liczba).

Odpowiedź na utworzenie

Kod HTTP 200 zwraca taskId (string) oraz credits (number). Oznacza to przyjęcie zadania do realizacji, a nie jego zakończenie. Wartość poniżej odpowiada 5-sekundowemu wideo 720p z sekcji szybkiego startu.

{
  "taskId": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "credits": 50
}

Tryby generowania i przykłady

Zastąp przykładowe adresy URL multimediów z domeny example.com własnymi, publicznie dostępnymi plikami HTTPS. Przykładowe adresy pokazują strukturę żądania i nie są plikami do pobrania.

Tekst na wideo

Generowanie na podstawie promptu tekstowego. Adresy URL multimediów nie są przekazywane w tym trybie.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'

Pierwsza klatka

Prześlij jeden obraz jako pierwszą klatkę, a następnie opisz ruch w prompcie.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "image-to-video",
    "image_urls": [
      "https://example.com/first-frame.jpg"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Pierwsza i ostatnia klatka

Prześlij dwa adresy URL obrazów w kolejności: pierwsza klatka, a następnie ostatnia klatka. Ten przykład żąda również wyodrębnienia ostatniej klatki wygenerowanego wideo.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "image-to-video",
    "image_urls": [
      "https://example.com/first-frame.jpg",
      "https://example.com/last-frame.jpg"
    ],
    "aspect_ratio": "adaptive",
    "return_last_frame": true
  }
}'

Referencja multimodalna

Połącz referencje obrazu, wideo i audio. Prompt tekstowy pozostaje wymagany. Przesłanie wideo referencyjnego zmienia sposób naliczania opłat.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "Follow the reference camera movement and keep the character consistent. Use the audio for ambience.",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "reference-to-video",
    "image_urls": [
      "https://example.com/character.jpg"
    ],
    "video_urls": [
      "https://example.com/camera.mp4"
    ],
    "audio_urls": [
      "https://example.com/ambience.mp3"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Referencja audio

Użyj dźwięku jako jedynego typu referencji wraz z wymaganym promptem tekstowym opisującym pożądane wideo.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "Create a coastal sunrise scene matching the rhythm of this audio.",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "reference-to-video",
    "audio_urls": [
      "https://example.com/music.mp3"
    ]
  }
}'

Edycja wideo

W przypadku edycji wideo w programie Seedance 2.5 Flash parametr duration musi mieć wartość -1, a aspect_ratio musi być ustawiony na adaptive. Wymagane jest skonfigurowanie obu tych ustawień – w przeciwnym razie wygenerowanie pliku się nie powiedzie.

Opisz edycję i prześlij wideo źródłowe. Ustaw duration=-1 i użyj proporcji adaptive. Do tego procesu użyj klipu źródłowego o długości co najmniej 4 sekund. Zasady rozliczeń dla wartości duration=-1 podano powyżej.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "Edit the source video: change the character’s coat to blue and preserve the camera movement.",
    "duration": -1,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "reference-to-video",
    "video_urls": [
      "https://example.com/source.mp4"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Przedłużenie wideo

W przypadku rozszerzenia wideo Seedance 2.5 Flash parametr aspect_ratio musi być ustawiony na adaptive – w przeciwnym razie generowanie może się nie powieść. Parametr duration należy ustawić normalnie, na żądaną długość wyjściowego wideo w obsługiwanym zakresie; nie ma potrzeby używania wartości -1.

Opisz, jak powinno kontynuować się wideo źródłowe. Użyj proporcji adaptive i ustaw standardowy czas trwania z zakresu obsługiwanego przez dany model.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "Continue the camera movement from the source video, revealing a forest clearing.",
    "duration": 8,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "reference-to-video",
    "video_urls": [
      "https://example.com/source.mp4"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Sprawdź stan zadania

GET https://api.seevio.ai/v1/tasks/{taskId}

Zastąp przykładowy identyfikator wartością taskId otrzymaną przy tworzeniu zadania. Zapytania zwracają wyłącznie zadania należące do użytkownika powiązanego z danym kluczem API; nieznane lub niedostępne identyfikatory zwracają HTTP 404.

Na początek odpytuj o stan co 10–20 sekund, wydłużaj odstępy w przypadku błędu HTTP 429 i przerwij, gdy status zmieni się na completed lub failed. W środowisku produkcyjnym zalecamy korzystanie z webhooków. Każdy poniższy przykład kodu wykonuje jedno zapytanie.

curl --fail-with-body https://api.seevio.ai/v1/tasks/3f2aK9mR7xQp4TnZ8bLc6YwH \
  -H "Authorization: Bearer $SEEVIO_API_KEY"
StatusOpis i ograniczenia
queuedZaakceptowano i oczekuje na uruchomienie.
generatingTrwa generowanie wideo.
completedZakończono sukcesem. Pobierz pliki z data.results przed upływem limitu czasu.
failedZakończono błędem. Sprawdź failed_reason oraz billing_status.
PoleTypOpis i ograniczenia
idstring
Identyfikator zadania. Jest to wartość taskId z odpowiedzi na utworzenie.
created_atnumber
Czas utworzenia zadania jako znacznik czasu Unix (w sekundach).
modelstring
Publiczny identyfikator modelu użyty do tego zadania.
billing_statusstring
Status rozliczenia: reserved (zarezerwowane), charged (pobrane), refunded (zwrócone) lub refund_failed (błąd zwrotu).
creditsnumber
Kredyty zarezerwowane dla tego zadania. Wartość ta jest widoczna również po zwrocie; sprawdź billing_status, aby poznać ostateczny wynik rozliczenia.
failed_reasonstring | null
Powód błędu dla zadań zakończonych niepowodzeniem; w przeciwnym razie null. Odpowiedzi na zapytania o błędne zadania nie zawierają obiektu data.
dataobject
Obecne w zapytaniach o zadania, które nie zakończyły się błędem. Zawiera szczegóły dotyczące wyniku i przetwarzania.
data.resultsstring[]
Tablica adresów URL wygenerowanych wideo. Pusta do momentu zakończenia zadania lub po wygaśnięciu plików wideo.
data.video_expires_atstring | null
Czas wygaśnięcia plików wideo jako znacznik czasu ISO 8601 (lub null, zanim plik będzie dostępny). Zapisz wynik przed tym czasem.
data.last_frame_urlstring | null
Adres URL ostatniej klatki (jeśli o nią wnioskowano i jest dostępna); w przeciwnym razie null.
data.processing_timenumber | null
Czas przetwarzania zadania w sekundach, jeśli jest dostępny; w przeciwnym razie wartość null.

Zakończone zadanie: odpowiedź na zapytanie z wynikowym wideo

Gdy zapytanie zwróci status=completed, oznacza to, że generowanie wideo zostało zakończone. Pobierz adresy URL materiałów wideo z pola data.results i zapisz pliki przed upływem czasu wskazanego w data.video_expires_at. Wartość billing_status=charged oznacza, że zarezerwowane kredyty zostały pobrane.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5-flash",
  "is_draft": false,
  "draft_task_id": null,
  "status": "completed",
  "billing_status": "charged",
  "credits": 50,
  "failed_reason": null,
  "data": {
    "results": [
      "https://cdn.seevio.ai/api/videos/example.mp4"
    ],
    "video_expires_at": "2026-09-07T00:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

Nieudane zadanie: odpowiedź na zapytanie ze szczegółami błędu i rozliczenia

Gdy zapytanie zwróci status=failed, oznacza to, że generowanie zakończyło się niepowodzeniem. Przyczynę błędu znajdziesz w polu failed_reason, a wynik zwrotu środków w billing_status. W tym przykładzie status refunded oznacza, że kredyty zostały zwrócone. Pole credits zachowuje pierwotnie zarezerwowaną wartość, a odpowiedź nie zawiera obiektu data.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5-flash",
  "is_draft": false,
  "draft_task_id": null,
  "status": "failed",
  "billing_status": "refunded",
  "credits": 50,
  "failed_reason": "provider_failed"
}

Webhooki

Ustaw parametr callback_url w żądaniu utworzenia, aby otrzymać żądanie POST z formatem JSON, gdy zadanie zostanie zakończone sukcesem lub błędem. Zwróć odpowiedź z kodem 2xx w ciągu 15 sekund. Nieudane doręczenia są ponawiane; powtarzające się wywołania należy przetwarzać idempotentnie na podstawie identyfikatora zadania.

Twój punkt końcowy (callback endpoint) musi akceptować żądania POST z treścią w formacie JSON (Content-Type: application/json).

Utwórz zadanie z wywołaniem zwrotnym (callback)

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  },
  "callback_url": "https://example.com/webhooks/seevio"
}'

Zadanie zakończone: struktura danych pomyślnego wywołania zwrotnego

Gdy generowanie zakończy się sukcesem, wywołanie zwrotne zawiera status=completed. Użyj parametru id do identyfikacji zadania, a data.results do pobrania adresów URL wideo. Pobierz i zapisz wyniki przed upływem czasu określonego w data.video_expires_at.

created_at oznacza czas utworzenia zdarzenia, a task_created_at zadania, w sekundach Unix. Przykłady pokazują zalecane pola; odpowiedzi mogą zawierać dodatkowe pola.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652848,
  "model": "seedance-2-5-flash",
  "status": "completed",
  "task_created_at": 1788652800,
  "billing_status": "charged",
  "credits": 50,
  "failed_reason": null,
  "data": {
    "results": [
      "https://cdn.seevio.ai/api/videos/example.mp4"
    ],
    "video_expires_at": "2026-09-07T00:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

Zadanie nie powiodło się: struktura danych błędu wywołania zwrotnego

Gdy generowanie nie powiedzie się, wywołanie zwrotne zawiera status=failed. Użyj parametru id do identyfikacji zadania, failed_reason, aby poznać przyczynę błędu, oraz credits_refunded, aby sprawdzić liczbę zwróconych kredytów.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652848,
  "model": "seedance-2-5-flash",
  "status": "failed",
  "task_created_at": 1788652800,
  "billing_status": "refunded",
  "credits": 50,
  "failed_reason": "provider_failed",
  "credits_refunded": 50
}

Przykładowy odbiorca

export async function POST(request: Request) {
  const callbackData = await request.json();

  if (callbackData.status === "completed") {
    const videoUrls = callbackData.data.results;
    // Save the video URLs and mark this task as completed in your application.
    console.log(callbackData.id, videoUrls);
  }

  if (callbackData.status === "failed") {
    const { failed_reason, credits_refunded } = callbackData;
    // Record the failure reason and refunded credits for this task.
    console.error(callbackData.id, failed_reason, credits_refunded);
  }

  return new Response(null, { status: 200 });
}

Ten przykład dla Next.js odczytuje treść wywołania zwrotnego JSON i bezpośrednio obsługuje zakończone oraz nieudane zadania. W swojej aplikacji dodaj mechanizm trwałości danych oraz deduplikację identyfikatorów zadań (task-ID). Przed potwierdzeniem odbioru wywołania zwrotnego dodaj czasochłonne operacje do kolejki.

Wymagania i ograniczenia plików

  • Wszystkie adresy URL multimediów i wywołań zwrotnych muszą być publicznymi adresami HTTPS. Unikaj adresów localhost, prywatnych IP oraz plików wymagających plików cookie lub logowania. Adresy URL referencyjnych wideo/audio muszą wskazywać bezpośrednio na pliki multimedialne.
  • W trybie reference-to-video prześlij co najmniej jedną referencję, maksymalnie do 30 obrazów, 10 wideo, 10 plików audio i łącznie do 50 materiałów. Łączny czas trwania wideo oraz łączny czas trwania audio nie mogą przekraczać 30 sekund każdy.
  • Tryb text-to-video ignoruje wszystkie referencje multimedialne. Tryb image-to-video uwzględnia wyłącznie obrazy pierwszej/ostatniej klatki, a ignoruje referencje wideo i audio. Aby łączyć różne multimedia, użyj trybu reference-to-video.
  • Każde referencyjne wideo oraz plik audio musi trwać od 2 do 30 sekund. W przypadku edycji wideo używaj klipów źródłowych o długości co najmniej 4 sekund.

Wymagania dotyczące obrazów

  • Rozmiar pojedynczego obrazu nie może przekraczać 30 MB.
  • Obsługiwane formaty: jpeg, png, webp, bmp, tiff, gif.
  • Proporcje obrazu (szerokość ÷ wysokość): od 0,4 do 2,5 włącznie.
  • Szerokość i wysokość muszą mieścić się w przedziale od 300 do 6000 pikseli włącznie.

Wymagania dotyczące filmów

  • Obsługiwane formaty: mp4, mov.
  • Rozmiar pojedynczego pliku wideo nie może przekraczać 100 MB.
  • Liczba klatek na sekundę: od 24 do 60 FPS włącznie.
  • Proporcje obrazu (szerokość ÷ wysokość): od 0,4 do 2,5 włącznie.
  • Całkowita liczba pikseli (szerokość × wysokość): od 407 696 do 8 295 044 włącznie. Na przykład: 614 × 664 = 407 696 oraz 3326 × 2494 = 8 295 044. Są to jedynie przykłady liczby pikseli, a nie sztywne wymagania dotyczące szerokości i wysokości.

Wymagania dotyczące dźwięku

  • Obsługiwane formaty: wav, mp3.
  • Rozmiar pojedynczego pliku audio nie może przekraczać 15 MB.