Folosește Seedance 2.5 prin Rivya Public API v1 cu model id seedance-2-5, intrări suportate, parametri, reguli Files API, credite și exemple de răspuns.

Disponibil prin APIText sau URL gata; modurile de referință folosesc Files APIVideo

ID model API

seedance-2-5

Intrări

text, file

Files API

Necesar pentru moduri de referință

Credite de bază

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⌉

Capabilitate

Video

Facturare

METERED

Limită prompt

30000 caractere

Contract cerere

Trimite model id la nivelul superior. Controalele specifice modelului aparțin în params.

Cheie	Tip	Necesar	Implicit	Descriere
model	string	Da	seedance-2-5	Folosește ID-ul de model API seedance-2-5.
prompt	string	Nu	-	Maximum 30000 caractere pentru acest model.
params	object	Nu	-	Obiect de parametri specific modelului. Folosește rândurile de mai jos pentru cheile permise.
client_request_id	string	Nu	-	ID opțional din partea clientului pentru urmărirea cererilor în sistemul tău.

Parametri model

Cheie	Tip	Necesar	Implicit	Interval	Opțiuni	Descriere
seedance_scene	select	Nu	text	-	text, frames, reference	Alege contractul de intrare înainte de încărcare; textul, ghidajul prin cadre și referințele sunt scenarii reciproc exclusive.
resolution	select	Nu	720p	-	480p, 720p, 1080p	Fiecare rezoluție are tarife separate pentru rulările fără video și cele cu video.
aspect_ratio	select	Nu	adaptive	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive	Raport de aspect
duration	number	Nu	5	min -1 / max 30 / step 1	-	Alege -1 pentru durată automată sau un număr întreg de la 4 până la 30 de secunde. Durata automată rezervă 30 de secunde de ieșire înainte de rulare.
output_format	select	Nu	mp4	-	mp4, mov	Format de ieșire
generate_audio	select	Nu	true	-	true, false	Solicită audio generat împreună cu clipul de ieșire.
return_last_frame	select	Nu	false	-	false, true	Returnează și cadrul video final ca imagine statică pentru verificare sau lucru ulterior.
web_search	select	Nu	false	-	false, true	Permite modelului să folosească pentru această rulare controlul său opțional de căutare pe web.
nsfw_checker	select	Nu	true	-	false, true	Activează filtrul de conținut opțional al modelului. Niciun filtru automat nu poate garanta acoperire completă.

Politică de încărcare

Încarcă mai întâi fișierele de referință, apoi pune URL-ul returnat și duration token în params.referenceMediaItems.

Regulă referință

Cadre de ghidaj sau referințe de mare capacitate: Frames acceptă 1 sau 2 imagini JPEG, PNG, WebP, BMP, GIF ori TIFF, de cel mult 30 MB fiecare. Reference acceptă până la 30 de imagini, 10 videoclipuri MP4/MOV de cel mult 95 MB și 2-30 de secunde fiecare și 10 fișiere audio MP3/WAV de cel mult 15 MB și 2-30 de secunde fiecare; duratele totale pentru video și audio sunt limitate separat la câte 30 de secunde, iar toate elementele media împreună sunt limitate la 50 de fișiere.

Max fișiere

Tipuri de fișiere acceptate

image, video, audio

Duration token

Referințele video și audio ar trebui să includă durationToken din /api/v1/files când verificarea duratei este necesară.

kind	Dimensiune max	Tipuri 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

Cerere minimă

{
  "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"
  }
}

Cerere cu fișier de referință

{
  "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"
      }
    ]
  }
}

Răspuns create

Endpointul create returnează un task id public. Interoghează endpointul de stare până când sarcina reușește sau eșuează.

{
  "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
}

Erori comune

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Unele moduri necesită încărcări de referință prin Files API.

Integrare API Seedance 2.5