Seedance 1.0 Lite API Integration
Seedance 1.0 Lite کو Rivya Public API v1 کے ذریعے model id seedance-1-0-lite، supported inputs، parameters، Files API rules، credits اور response examples کے ساتھ استعمال کریں۔
seedance-1-0-lite
text, file
Reference modes کے لیے required
16
ویڈیو
FIXED
10000 characters
Request contract
model id کو top level پر بھیجیں۔ Model-specific controls params میں رہتے ہیں۔
| Key | Type | Required | Default | Description |
|---|---|---|---|---|
| model | string | Yes | seedance-1-0-lite | seedance-1-0-lite API model id استعمال کریں۔ |
| prompt | string | Yes | - | اس model کے لیے زیادہ سے زیادہ 10000 characters۔ |
| params | object | No | - | Model-specific parameter object۔ allowed keys کے لیے نیچے والی rows استعمال کریں۔ |
| client_request_id | string | No | - | آپ کے system میں requests trace کرنے کے لیے optional client-side id۔ |
Model parameters
| Key | Type | Required | Default | Range | Options | Description |
|---|---|---|---|---|---|---|
| resolution | select | No | 720p | - | 480p, 720p, 1080p | ریزولوشن |
| duration | select | No | 5 | - | 5, 10 | دورانیہ |
| aspect_ratio | select | No | 16:9 | - | 16:9, 4:3, 1:1, 3:4, 9:16, 9:21 | پہلو کا تناسب |
| camera_fixed | select | No | false | - | false, true | یہ control طے کرتا ہے کہ shot fixed camera کی طرح behave کرے یا نہیں۔ اسے on کرنے سے camera motion زیادہ restrained رہتی ہے؛ off کرنے سے زیادہ واضح movement کی اجازت ملتی ہے۔ |
| seed | number | No | -1 | min -1 / max 2147483647 | - | ہر بار نیا random result چاہیے ہو تو اسے empty چھوڑیں۔ اسی integer کو دوبارہ use کرنے سے previous result reproduce یا fine-tune کرنا آسان ہوتا ہے۔ Result صرف اسی وقت زیادہ قریب رہتا ہے جب prompt اور دوسرے key settings بھی similar رہیں، اور یہ guaranteed 1:1 match نہیں ہوتا۔ |
| enable_safety_checker | select | No | true | - | true, false | سیفٹی چیکر |
Upload policy
Reference files پہلے upload کریں، پھر returned URL اور duration token کو params.referenceMediaItems کے اندر رکھیں۔
حوالہ تصویر: image-to-video کے لیے 1 source image upload کریں، یا جب آپ optional end frame بھی دینا چاہتے ہوں تو 2 images upload کریں۔
2
image
duration verification required ہو تو video اور audio references کو /api/v1/files سے durationToken ساتھ رکھنا چاہیے۔
| 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
create endpoint ایک public task id واپس کرتا ہے۔ task succeeded یا failed ہونے تک status endpoint poll کریں۔
{
"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
کچھ modes کو Files API reference uploads درکار ہوتے ہیں۔