Rivya AI दस्तावेज़
मॉडल API पेज

Seedance 2.5 API इंटीग्रेशन

Rivya Public API v1 के जरिए मॉडल ID seedance-2-5, समर्थित इनपुट, पैरामीटर, Files API नियम, क्रेडिट और रिस्पॉन्स उदाहरणों के साथ Seedance 2.5 का उपयोग करें।

API से उपलब्धटेक्स्ट या URL तैयार; संदर्भ मोड में Files API का उपयोग होता हैवीडियो
API मॉडल ID

seedance-2-5

इनपुट

text, file

Files API

संदर्भ मोड के लिए जरूरी

बेस क्रेडिट

per_input_and_output_second · 480p_with_video=17 · 480p_without_video=28 · 720p_with_video=38 · 720p_without_video=63 · 1080p_with_video=68.5 · 1080p_without_video=114 · ⌈total⌉

क्षमता

वीडियो

बिलिंग

METERED

प्रॉम्प्ट सीमा

30000 अक्षर

रिक्वेस्ट संरचना

मॉडल ID को शीर्ष स्तर पर भेजें। मॉडल के लिए खास कंट्रोल params में रखें।

कुंजीप्रकारजरूरीडिफॉल्टविवरण
modelstringहांseedance-2-5seedance-2-5 API मॉडल ID का उपयोग करें।
promptstringनहीं-इस मॉडल के लिए अधिकतम 30000 अक्षर।
paramsobjectनहीं-मॉडल के लिए खास पैरामीटर ऑब्जेक्ट। अनुमत key के लिए नीचे दी गई पंक्तियां देखें।
client_request_idstringनहीं-अपने सिस्टम में रिक्वेस्ट ट्रेस करने के लिए वैकल्पिक क्लाइंट-साइड ID।

मॉडल पैरामीटर

कुंजीप्रकारजरूरीडिफॉल्टसीमाविकल्पविवरण
seedance_sceneselectनहींtext-text, frames, referenceअपलोड से पहले इनपुट अनुबंध चुनें; टेक्स्ट, फ्रेम मार्गदर्शन और रेफरेंस परस्पर अलग दृश्य हैं।
resolutionselectनहीं720p-480p, 720p, 1080pहर रिज़ॉल्यूशन के लिए बिना-वीडियो और वीडियो-सहित अलग दरें हैं।
aspect_ratioselectनहींadaptive-1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptiveआस्पेक्ट रेशियो
durationnumberनहीं5min -1 / max 30 / step 1-स्वचालित अवधि के लिए -1 या 4 से 30 सेकंड तक पूर्णांक चुनें। स्वचालित अवधि रन से पहले 30 आउटपुट सेकंड आरक्षित करती है।
output_formatselectनहींmp4-mp4, movआउटपुट फ़ॉर्मेट
generate_audioselectनहींtrue-true, falseआउटपुट क्लिप के साथ जनरेट किया गया ऑडियो माँगें।
return_last_frameselectनहींfalse-false, trueसमीक्षा या आगे के काम के लिए वीडियो के अंतिम फ्रेम को स्थिर इमेज के रूप में भी लौटाएँ।
web_searchselectनहींfalse-false, trueमॉडल को इस रन में वैकल्पिक वेब-खोज नियंत्रण इस्तेमाल करने दें।
nsfw_checkerselectनहींtrue-false, trueमॉडल का वैकल्पिक कंटेंट फ़िल्टर चालू करें। कोई स्वचालित फ़िल्टर पूर्ण कवरेज की गारंटी नहीं दे सकता।

अपलोड नीति

पहले संदर्भ फाइल अपलोड करें, फिर लौटे हुए URL और durationToken को params.referenceMediaItems में रखें।

संदर्भ नियम

मार्गदर्शक फ्रेम या बड़ी क्षमता वाले रेफरेंस: फ्रेम दृश्य अधिकतम 30 MB की 1 या 2 JPEG, PNG, WebP, BMP, GIF या TIFF इमेज स्वीकार करता है। रेफरेंस दृश्य अधिकतम 30 इमेज, 95 MB और 2-30 सेकंड तक के 10 MP4/MOV वीडियो तथा 15 MB और 2-30 सेकंड तक की 10 MP3/WAV ऑडियो फ़ाइलें स्वीकार करता है; वीडियो और ऑडियो की कुल अवधि अपने-अपने मीडिया प्रकार के लिए 30 सेकंड तक सीमित है और सभी मीडिया मिलाकर 50 फ़ाइलों तक सीमित हैं।

अधिकतम फाइलें

50

स्वीकार्य फाइल प्रकार

image, video, audio

durationToken

अवधि सत्यापन जरूरी होने पर वीडियो और ऑडियो संदर्भों में /api/v1/files से मिला durationToken होना चाहिए।

kindअधिकतम आकारMIME प्रकार
image30 MBimage/jpeg, image/png, image/webp, image/bmp, image/gif, image/tiff
video95 MBvideo/mp4, video/quicktime
audio15 MBaudio/mpeg, audio/wav, audio/x-wav

न्यूनतम रिक्वेस्ट

{
  "model": "seedance-2-5",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "output_format": "mp4",
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "true"
  }
}

संदर्भ फाइल रिक्वेस्ट

{
  "model": "seedance-2-5",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "reference",
    "resolution": "720p",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "output_format": "mp4",
    "generate_audio": "true",
    "return_last_frame": "false",
    "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"
      }
    ]
  }
}

Create रिस्पॉन्स

create एंडपॉइंट सार्वजनिक टास्क ID लौटाता है। टास्क सफल या विफल होने तक स्टेटस एंडपॉइंट पोल करें।

{
  "id": "task_seedance_2_5_example",
  "status": "queued",
  "model": "seedance-2-5",
  "reserved_credits": 315,
  "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
}

सामान्य त्रुटियां

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

कुछ मोड में Files API संदर्भ अपलोड जरूरी हैं।