Check Seedance 2.0 Mini availability, inputs, parameters, file requirements, credit pricing, and request examples for Rivya Public API v1. Model ID: seedance-2-mini.

Available via APIText or URL ready; reference modes use Files APIVideo

API model ID

seedance-2-mini

Inputs

text, file

Files API

Required for reference modes

Credit pricing

Credit rate: 2.4–8.2 per second of total video duration (input + output) The final cost is rounded up to whole credits.

Capability

Video

Billing

METERED

Prompt limit

20000 characters

Request fields

Set model at the top level. Put model-specific controls and reference inputs in params, using the format documented for this model.

Key	Type	Required	Default	Description
model	string	Yes	seedance-2-mini	Set model to seedance-2-mini.
prompt	string	Yes	-	Maximum 20000 characters for this model.
params	object	No	-	The model-specific params object. Use the documented keys and reference-file format for this model.
client_request_id	string	No	-	Optional ID for tracing this request in your system. It does not replace Idempotency-Key.

Model parameters

Key	Type	Required	Default	Range	Options	Description
seedance_scene	select	No	text	-	text, frames, reference	Choose Text to video without uploads, Frames with one or two images, or Reference with image, video or audio inputs. Use one mode per generation.
resolution	select	No	720p	-	480p, 720p	Credits depend on resolution and whether your references include video. Check the estimate before generating.
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 / step 1	-	Choose a whole-number output duration from 4 through 15 seconds.
generate_audio	select	No	true	-	true, false	Generated audio is on by default. Turn it off for a clip without model-generated audio.
web_search	select	No	false	-	false, true	Available only for text-to-video; enabling it with frames or references is rejected.
nsfw_checker	select	No	true	-	false, true	The model's content filter is on by default. You can turn it off; automated filtering does not catch every case.

Upload policy

Upload reference files through Files API first. Keep the original URLs, verified metadata, and tokens. Follow this model's request example: some models use params.referenceMediaItems, while others use different fields.

Reference rule

Guide frames or multimodal references: For Frames, upload one or two JPEG/PNG/WebP/GIF images up to 30 MB each. Reference accepts up to 9 images in those formats, 3 MP4/MOV videos up to 50 MB each, and 3 MP3/WAV audio files up to 15 MB each. Each video or audio file must last 2–15 seconds; video and audio each have a separate 15-second total limit.

Max files

Accepted file kinds

image, video, audio

Duration token

When duration verification is required, use duration_token from /api/v1/files as durationToken in the request. Keep any additional signed metadata this model requires.

kind	Max size	MIME types
image	30 MB	image/jpeg, image/png, image/webp, image/gif
video	50 MB	video/mp4, video/quicktime
audio	15 MB	audio/mpeg, audio/wav, audio/x-wav

Minimal request

{
  "model": "seedance-2-mini",
  "prompt": "A camera slowly circles a product bottle on a studio table.",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "web_search": "false",
    "nsfw_checker": "true"
  }
}

Reference-file request

{
  "model": "seedance-2-mini",
  "prompt": "A camera slowly circles a product bottle on a studio table.",
  "params": {
    "seedance_scene": "reference",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "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"
      }
    ]
  }
}

Example response

An accepted generation request returns a task ID. Poll the status endpoint until the task succeeds or fails. A status request failure does not mean generation failed.

{
  "id": "task_seedance_2_mini_example",
  "status": "queued",
  "model": "seedance-2-mini",
  "reserved_credits": 41,
  "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
}

Common errors

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Some modes require Files API reference uploads.

Seedance 2.0 Mini API reference