Seedance 1.5 Pro API Integration
Seedance 1.5 Pro کو Rivya Public API v1 کے ذریعے model id seedance-1-5-pro، supported inputs، parameters، Files API rules، credits اور response examples کے ساتھ استعمال کریں۔
seedance-1-5-pro
text, file
Reference modes کے لیے required
28
ویڈیو
FIXED
2500 characters
Request contract
model id کو top level پر بھیجیں۔ Model-specific controls params میں رہتے ہیں۔
| Key | Type | Required | Default | Description |
|---|---|---|---|---|
| model | string | Yes | seedance-1-5-pro | seedance-1-5-pro API model id استعمال کریں۔ |
| prompt | string | Yes | - | اس model کے لیے زیادہ سے زیادہ 2500 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 | 8 | - | 4, 8, 12 | دورانیہ |
| generate_audio | select | No | false | - | false, true | Audio بنائیں |
| aspectRatio | select | No | 1:1 | - | 1:1, 4:3, 3:4, 16:9, 9:16, 21:9 | فریم تناسب |
| fixed_lens | select | No | false | - | false, true | یہ control کرتا ہے کہ shot کو زیادہ fixed camera جیسا behave کرنا چاہیے یا نہیں۔ آن کرنے سے camera motion زیادہ restrained رہتا ہے؛ آف کرنے سے movement زیادہ واضح ہو سکتی ہے۔ |
Upload policy
Reference files پہلے upload کریں، پھر returned URL اور duration token کو params.referenceMediaItems کے اندر رکھیں۔
ریفرنس تصویر: Image projects کے لیے 2 image files تک 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-5-pro",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"resolution": "720p",
"duration": "8",
"generate_audio": "false",
"aspectRatio": "1:1",
"fixed_lens": "false"
}
}Reference-file request
{
"model": "seedance-1-5-pro",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"resolution": "720p",
"duration": "8",
"generate_audio": "false",
"aspectRatio": "1:1",
"fixed_lens": "false",
"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_5_pro_example",
"status": "queued",
"model": "seedance-1-5-pro",
"reserved_credits": 28,
"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 درکار ہوتے ہیں۔