Gebruik Seedance 2.5 via Rivya Public API v1 met model-id seedance-2-5, ondersteunde inputs, parameters, Files API-regels, credits en responsevoorbeelden.

Beschikbaar via APITekst of URL gereed; referentiemodi gebruiken Files APIVideo

API-model-id

seedance-2-5

Inputs

text, file

Files API

Vereist voor referentiemodi

Basiscredits

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⌉

Mogelijkheid

Video

Facturering

METERED

Promptlimiet

30000 tekens

Requestcontract

Stuur de model-id op topniveau. Modelspecifieke controles horen in params.

Key	Type	Vereist	Standaard	Beschrijving
model	string	Ja	seedance-2-5	Gebruik de API-model-id seedance-2-5.
prompt	string	Nee	-	Maximaal 30000 tekens voor dit model.
params	object	Nee	-	Modelspecifiek parameterobject. Gebruik de rijen hieronder voor toegestane keys.
client_request_id	string	Nee	-	Optionele client-side id voor requesttracing in je systeem.

Modelparameters

Key	Type	Vereist	Standaard	Bereik	Opties	Beschrijving
seedance_scene	select	Nee	text	-	text, frames, reference	Kies vóór het uploaden het invoercontract; tekst, framebegeleiding en referenties zijn onderling exclusieve scènes.
resolution	select	Nee	720p	-	480p, 720p, 1080p	Elke resolutie heeft afzonderlijke tarieven zonder en met video.
aspect_ratio	select	Nee	adaptive	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive	Beeldverhouding
duration	number	Nee	5	min -1 / max 30 / step 1	-	Kies -1 voor automatische duur of een geheel getal van 4 tot en met 30 seconden. Automatische duur reserveert vóór de run 30 uitvoerseconden.
output_format	select	Nee	mp4	-	mp4, mov	Uitvoerformaat
generate_audio	select	Nee	true	-	true, false	Vraag gegenereerde audio aan bij de uitvoerclip.
return_last_frame	select	Nee	false	-	false, true	Geef ook het laatste videoframe als stilstaand beeld terug voor review of vervolgwerk.
web_search	select	Nee	false	-	false, true	Sta toe dat het model voor deze run de optionele webzoekfunctie gebruikt.
nsfw_checker	select	Nee	true	-	false, true	Schakel het optionele contentfilter van het model in. Geen enkel geautomatiseerd filter kan volledige dekking garanderen.

Uploadbeleid

Upload eerst referentiebestanden en plaats daarna de teruggegeven URL en duration token in params.referenceMediaItems.

Referentieregel

Richtingsframes of referenties met hoge capaciteit: Frames accepteert 1 of 2 JPEG-, PNG-, WebP-, BMP-, GIF- of TIFF-afbeeldingen van maximaal 30 MB per stuk. Referentie accepteert maximaal 30 afbeeldingen, 10 MP4/MOV-video's van maximaal 95 MB en 2-30 seconden per stuk en 10 MP3/WAV-audiobestanden van maximaal 15 MB en 2-30 seconden per stuk; video en audio zijn elk begrensd op in totaal 30 seconden en alle media samen op 50 bestanden.

Max. bestanden

Geaccepteerde bestandstypen

image, video, audio

Duurtoken

Video- en audioreferenties moeten durationToken uit /api/v1/files bevatten wanneer duurverificatie vereist is.

kind	Max. grootte	MIME-types
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

Minimale request

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

Request met referentiebestand

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

Create-response

Het create-endpoint geeft een publieke taak-id terug. Poll het statusendpoint totdat de taak slaagt of mislukt.

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

Veelvoorkomende fouten

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Sommige modi vereisen referentie-uploads via Files API.

Seedance 2.5 API-integratie