Seedance 1.0 Pro API इंटीग्रेशन
Rivya Public API v1 के जरिए मॉडल ID seedance-1-0-pro, समर्थित इनपुट, पैरामीटर, Files API नियम, क्रेडिट और रिस्पॉन्स उदाहरणों के साथ Seedance 1.0 Pro का उपयोग करें।
seedance-1-0-pro
text, file
संदर्भ मोड के लिए जरूरी
25
वीडियो
FIXED
10000 अक्षर
रिक्वेस्ट संरचना
मॉडल ID को शीर्ष स्तर पर भेजें। मॉडल के लिए खास कंट्रोल params में रखें।
| कुंजी | प्रकार | जरूरी | डिफॉल्ट | विवरण |
|---|---|---|---|---|
| model | string | हां | seedance-1-0-pro | seedance-1-0-pro API मॉडल ID का उपयोग करें। |
| prompt | string | हां | - | इस मॉडल के लिए अधिकतम 10000 अक्षर। |
| params | object | नहीं | - | मॉडल के लिए खास पैरामीटर ऑब्जेक्ट। अनुमत key के लिए नीचे दी गई पंक्तियां देखें। |
| client_request_id | string | नहीं | - | अपने सिस्टम में रिक्वेस्ट ट्रेस करने के लिए वैकल्पिक क्लाइंट-साइड ID। |
मॉडल पैरामीटर
| कुंजी | प्रकार | जरूरी | डिफॉल्ट | सीमा | विकल्प | विवरण |
|---|---|---|---|---|---|---|
| resolution | select | नहीं | 720p | - | 480p, 720p, 1080p | रिजॉल्यूशन |
| duration | select | नहीं | 5 | - | 5, 10 | अवधि |
| aspect_ratio | select | नहीं | 16:9 | - | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | आस्पेक्ट रेशियो |
| camera_fixed | select | नहीं | false | - | false, true | Shot को fixed camera जैसा behave करना चाहिए या नहीं, यह control करता है। इसे on करने से camera motion ज्यादा restrained रहती है; off करने से ज्यादा obvious movement allowed होती है। |
| seed | number | नहीं | -1 | min -1 / max 2147483647 | - | हर बार नया यादृच्छिक नतीजा पाने के लिए इसे खाली छोड़ें। वही पूर्णांक दोबारा इस्तेमाल करने से पिछले नतीजे को दोहराना या बारीक समायोजित करना आसान होता है। नतीजा तभी ज्यादा करीब रहता है जब प्रॉम्प्ट और बाकी मुख्य सेटिंग भी मिलती-जुलती रहें; फिर भी यह 1:1 मिलान की गारंटी नहीं है। |
| enable_safety_checker | select | नहीं | true | - | true, false | Safety checker नियंत्रण |
अपलोड नीति
पहले संदर्भ फाइल अपलोड करें, फिर लौटे हुए URL और durationToken को params.referenceMediaItems में रखें।
रेफरेंस इमेज: Image-to-video runs के लिए 1 image file upload करें।
1
image
अवधि सत्यापन जरूरी होने पर वीडियो और ऑडियो संदर्भों में /api/v1/files से मिला durationToken होना चाहिए।
| kind | अधिकतम आकार | MIME प्रकार |
|---|---|---|
| image | 10 MB | image/jpeg, image/png, image/webp |
न्यूनतम रिक्वेस्ट
{
"model": "seedance-1-0-pro",
"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"
}
}संदर्भ फाइल रिक्वेस्ट
{
"model": "seedance-1-0-pro",
"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 रिस्पॉन्स
create एंडपॉइंट सार्वजनिक टास्क ID लौटाता है। टास्क सफल या विफल होने तक स्टेटस एंडपॉइंट पोल करें।
{
"id": "task_seedance_1_0_pro_example",
"status": "queued",
"model": "seedance-1-0-pro",
"reserved_credits": 25,
"final_credits": 0,
"created_at": "2026-05-11T00:00:00.000Z",
"updated_at": "2026-05-11T00:00:00.000Z",
"result": null,
"error": null
}सामान्य त्रुटियां
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
कुछ मोड में Files API संदर्भ अपलोड जरूरी हैं।