Use Seedance 2.0 through Rivya Public API v1 with model id seedance-2, supported inputs, parameters, Files API rules, credits, and response examples.

Available via APIText input readyVideo

API model id

seedance-2

Inputs

text

Files API

Not required for the minimal request

Base credits

175

Capability

Video

Billing

FIXED

Prompt limit

2500 characters

Request contract

Send the model id at the top level. Model-specific controls belong in params.

Key	Type	Required	Default	Description
model	string	Yes	seedance-2	Use the seedance-2 API model id.
prompt	string	Yes	-	Maximum 2500 characters for this model.
params	object	No	-	Model-specific parameter object. Use the rows below for allowed keys.
client_request_id	string	No	-	Optional client-side id for tracing requests in your system.

Model parameters

Key	Type	Required	Default	Range	Options	Description
seedance_scene	select	No	text	-	text, frames, reference	Selects which Seedance 2 path to run: pure text-to-video, first-frame / first-last-frame guidance, or multimodal reference generation.
resolution	select	No	720p	-	480p, 720p	Resolution
aspect_ratio	select	No	16:9	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive	Aspect ratio
duration	number	No	5	min 4 / max 15	-	Duration
generate_audio	select	No	true	-	true, false	Generate audio
return_last_frame	select	No	false	-	false, true	Also returns the final frame as a still image, which is useful for covers, follow-up runs, or later editing.
web_search	select	No	false	-	false, true	Web search
nsfw_checker	select	No	false	-	false, true	NSFW checker

Minimal request

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

Create response

The create endpoint returns a public task id. Poll the status endpoint until the task succeeds or fails.

{
  "id": "task_seedance_2_example",
  "status": "queued",
  "model": "seedance-2",
  "reserved_credits": 175,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Common errors

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found