Używaj Seedance 2.5 przez Rivya Public API v1 z identyfikatorem modelu seedance-2-5, obsługiwanymi wejściami, parametrami, regułami Files API, kredytami i przykładami odpowiedzi.

Dostępne przez APITekst lub URL gotowe; tryby referencyjne używają Files APIWideo

Identyfikator modelu API

seedance-2-5

Wejścia

text, file

Files API

Wymagane dla trybów referencyjnych

Kredyty bazowe

per_input_and_output_second · 480p_with_video=17 · 480p_without_video=28 · 720p_with_video=38 · 720p_without_video=63 · 1080p_with_video=68.5 · 1080p_without_video=114 · ⌈total⌉

Możliwość

Wideo

Rozliczenia

METERED

Limit promptu

30000 znaków

Kontrakt żądania

Wyślij identyfikator modelu na najwyższym poziomie. Kontrolki specyficzne dla modelu należą do params.

Klucz	Typ	Wymagane	Domyślnie	Opis
model	string	Tak	seedance-2-5	Użyj seedance-2-5 jako identyfikatora modelu API.
prompt	string	Nie	-	Maksymalnie 30000 znaków dla tego modelu.
params	object	Nie	-	Obiekt parametrów specyficznych dla modelu. Dozwolone klucze znajdziesz w wierszach poniżej.
client_request_id	string	Nie	-	Opcjonalny identyfikator po stronie klienta do śledzenia żądań w Twoim systemie.

Parametry modelu

Klucz	Typ	Wymagane	Domyślnie	Zakres	Opcje	Opis
seedance_scene	select	Nie	text	-	text, frames, reference	Wybierz kontrakt wejściowy przed przesłaniem plików; tekst, prowadzenie klatkami i referencje to wzajemnie wykluczające się sceny.
resolution	select	Nie	720p	-	480p, 720p, 1080p	Każda rozdzielczość ma osobne stawki bez wideo i z wideo.
aspect_ratio	select	Nie	adaptive	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive	Proporcje obrazu
duration	number	Nie	5	min -1 / max 30 / step 1	-	Wybierz -1 dla czasu automatycznego albo liczbę całkowitą od 4 do 30 sekund. Czas automatyczny rezerwuje 30 sekund wyniku przed uruchomieniem.
output_format	select	Nie	mp4	-	mp4, mov	Format wyniku
generate_audio	select	Nie	true	-	true, false	Poproś o wygenerowane audio razem z klipem wynikowym.
return_last_frame	select	Nie	false	-	false, true	Zwróć również końcową klatkę wideo jako nieruchomy obraz do oceny lub dalszej pracy.
web_search	select	Nie	false	-	false, true	Zezwól modelowi na użycie opcjonalnego wyszukiwania w sieci w tym przebiegu.
nsfw_checker	select	Nie	true	-	false, true	Włącz opcjonalny filtr modelu. Żaden automatyczny filtr nie gwarantuje pełnego pokrycia.

Zasady przesyłania

Najpierw prześlij pliki referencyjne, a potem umieść zwrócony URL i token czasu trwania w params.referenceMediaItems.

Reguła referencji

Klatki prowadzące lub pojemne referencje: Klatki przyjmują 1 lub 2 obrazy JPEG, PNG, WebP, BMP, GIF albo TIFF do 30 MB każdy. Referencja przyjmuje maksymalnie 30 obrazów, 10 wideo MP4/MOV do 95 MB i 2-30 sekund każde oraz 10 plików audio MP3/WAV do 15 MB i 2-30 sekund każdy; łączny czas wideo i audio jest osobno ograniczony do 30 sekund, a wszystkie media łącznie do 50 plików.

Maks. plików

Akceptowane rodzaje plików

image, video, audio

Token czasu trwania

Referencje wideo i audio powinny zawierać durationToken z /api/v1/files, gdy wymagana jest weryfikacja czasu trwania.

kind	Maks. rozmiar	Typy MIME
image	30 MB	image/jpeg, image/png, image/webp, image/bmp, image/gif, image/tiff
video	95 MB	video/mp4, video/quicktime
audio	15 MB	audio/mpeg, audio/wav, audio/x-wav

Żądanie minimalne

{
  "model": "seedance-2-5",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "output_format": "mp4",
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "true"
  }
}

Żądanie z plikiem referencyjnym

{
  "model": "seedance-2-5",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "reference",
    "resolution": "720p",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "output_format": "mp4",
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "true",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-video.mp4",
        "kind": "video",
        "name": "reference-video.mp4",
        "mimeType": "video/mp4",
        "durationSeconds": 8,
        "durationToken": "video_duration_token_from_files_api",
        "width": 1280,
        "height": 720,
        "sizeBytes": 8388608,
        "framesPerSecond": 30,
        "videoBitrateMbps": 8,
        "videoMetadataToken": "video_metadata_token_from_original_files_api_upload_response"
      }
    ]
  }
}

Odpowiedź tworzenia

Endpoint tworzenia zwraca publiczny identyfikator zadania. Odpytuj endpoint statusu, aż zadanie zakończy się powodzeniem albo błędem.

{
  "id": "task_seedance_2_5_example",
  "status": "queued",
  "model": "seedance-2-5",
  "reserved_credits": 315,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Typowe błędy

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Niektóre tryby wymagają przesłania materiałów referencyjnych przez Files API.

Integracja API Seedance 2.5