Seedance 1.0 Lite API Integration
Use Seedance 1.0 Lite through Rivya Public API v1 with model id seedance-1-0-lite, supported inputs, parameters, Files API rules, credits, and response examples.
seedance-1-0-lite
text, file
Required for reference modes
16
Video
FIXED
10000 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-1-0-lite | Use the seedance-1-0-lite API model id. |
| prompt | string | Yes | - | Maximum 10000 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 |
|---|---|---|---|---|---|---|
| resolution | select | No | 720p | - | 480p, 720p, 1080p | Resolution |
| duration | select | No | 5 | - | 5, 10 | Duration |
| aspect_ratio | select | No | 16:9 | - | 16:9, 4:3, 1:1, 3:4, 9:16, 9:21 | Aspect ratio |
| camera_fixed | select | No | false | - | false, true | Controls whether the shot should behave more like a fixed camera. Turning it on keeps camera motion more restrained; turning it off allows more obvious movement. |
| seed | number | No | -1 | min -1 / max 2147483647 | - | Leave it empty for a new random result each time. Reusing the same integer makes it easier to reproduce or fine-tune a previous result. It stays closer only when the prompt and other key settings also remain similar, and it is not a guaranteed 1:1 match. |
| enable_safety_checker | select | No | true | - | true, false | Safety checker |
Upload policy
Upload reference files first, then place the returned URL and duration token inside params.referenceMediaItems.
Reference image: Upload 1 source image for image-to-video, or 2 images when you also want to provide an optional end frame.
2
image
Video and audio references should carry durationToken from /api/v1/files when duration verification is required.
| kind | Max size | MIME types |
|---|---|---|
| image | 10 MB | image/jpeg, image/png, image/webp |
Minimal request
{
"model": "seedance-1-0-lite",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"resolution": "720p",
"duration": "5",
"aspect_ratio": "16:9",
"camera_fixed": "false",
"seed": -1,
"enable_safety_checker": "true"
}
}Reference-file request
{
"model": "seedance-1-0-lite",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"resolution": "720p",
"duration": "5",
"aspect_ratio": "16:9",
"camera_fixed": "false",
"seed": -1,
"enable_safety_checker": "true",
"referenceMediaItems": [
{
"url": "https://cdn.example.com/reference-image.png",
"kind": "image",
"name": "reference-image.png",
"mimeType": "image/png"
}
]
}
}Create response
The create endpoint returns a public task id. Poll the status endpoint until the task succeeds or fails.
{
"id": "task_seedance_1_0_lite_example",
"status": "queued",
"model": "seedance-1-0-lite",
"reserved_credits": 16,
"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
Some modes require Files API reference uploads.