Wan 2.5 Video API इंटीग्रेशन
Rivya Public API v1 के जरिए मॉडल id wan-2-5-video, समर्थित इनपुट, पैरामीटर, Files API नियम, क्रेडिट और रिस्पॉन्स उदाहरणों के साथ Wan 2.5 Video का उपयोग करें।
wan-2-5-video
text, file
संदर्भ mode के लिए जरूरी
60
वीडियो
FIXED
5000 अक्षर
रिक्वेस्ट अनुबंध
मॉडल id को शीर्ष स्तर पर भेजें। मॉडल के लिए खास कंट्रोल params में रखें।
| Key | प्रकार | जरूरी | डिफॉल्ट | विवरण |
|---|---|---|---|---|
| model | string | हां | wan-2-5-video | wan-2-5-video API मॉडल id का उपयोग करें। |
| prompt | string | हां | - | इस मॉडल के लिए अधिकतम 5000 अक्षर। |
| params | object | नहीं | - | मॉडल के लिए खास पैरामीटर ऑब्जेक्ट। अनुमत keys के लिए नीचे दी गई पंक्तियां देखें। |
| client_request_id | string | नहीं | - | अपने सिस्टम में रिक्वेस्ट ट्रेस करने के लिए वैकल्पिक client-side id। |
मॉडल पैरामीटर
| Key | प्रकार | जरूरी | डिफॉल्ट | सीमा | विकल्प | विवरण |
|---|---|---|---|---|---|---|
| resolution | select | नहीं | 720p | - | 720p, 1080p | Resolution tier |
| duration | select | नहीं | 5 | - | 5, 10 | Duration setting |
| aspect_ratio | select | नहीं | 16:9 | - | 16:9, 9:16, 1:1 | Aspect ratio नियंत्रण |
| enable_prompt_expansion | select | नहीं | false | - | false, true | Enabled होने पर Rivya upstream model को extra detail के साथ आपका prompt expand करने देता है, original intent preserve रखते हुए। जब आपका prompt पहले से tightly written हो, तब इसे off करें। |
| seed | number | नहीं | - | min 0 / max 2147483647 | - | हर बार नया यादृच्छिक नतीजा पाने के लिए इसे खाली छोड़ें। वही पूर्णांक दोबारा इस्तेमाल करने से पिछले नतीजे को दोहराना या बारीक समायोजित करना आसान होता है। नतीजा तभी ज्यादा करीब रहता है जब प्रॉम्प्ट और बाकी मुख्य सेटिंग भी मिलती-जुलती रहें; फिर भी यह 1:1 मिलान की गारंटी नहीं है। |
| negative_prompt | text | नहीं | - | - | - | Negative prompt field |
| nsfw_checker | select | नहीं | false | - | false, true | NSFW checker नियंत्रण |
अपलोड नीति
पहले संदर्भ फाइल अपलोड करें, फिर लौटे हुए URL और duration token को params.referenceMediaItems में रखें।
Reference image जोड़ें: Image-to-video mode के लिए 1 तक image file upload करें।
1
image
अवधि सत्यापन जरूरी होने पर वीडियो और ऑडियो संदर्भों में /api/v1/files से मिला durationToken होना चाहिए।
| kind | अधिकतम आकार | MIME प्रकार |
|---|---|---|
| image | 10 MB | image/jpeg, image/png, image/webp |
न्यूनतम रिक्वेस्ट
{
"model": "wan-2-5-video",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"resolution": "720p",
"duration": "5",
"aspect_ratio": "16:9",
"enable_prompt_expansion": "false",
"seed": 0,
"negative_prompt": "Optional exclusions या avoid करने योग्य failure modes.",
"nsfw_checker": "false"
}
}संदर्भ फाइल रिक्वेस्ट
{
"model": "wan-2-5-video",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"resolution": "720p",
"duration": "5",
"aspect_ratio": "16:9",
"enable_prompt_expansion": "false",
"seed": 0,
"negative_prompt": "Optional exclusions या avoid करने योग्य failure modes.",
"nsfw_checker": "false",
"referenceMediaItems": [
{
"url": "https://cdn.example.com/reference-image.png",
"kind": "image",
"name": "reference-image.png",
"mimeType": "image/png"
}
]
}
}रिस्पॉन्स बनाएं
Create एंडपॉइंट सार्वजनिक टास्क id लौटाता है। टास्क सफल या विफल होने तक स्टेटस एंडपॉइंट पोल करें।
{
"id": "task_wan_2_5_video_example",
"status": "queued",
"model": "wan-2-5-video",
"reserved_credits": 60,
"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
कुछ mode में Files API संदर्भ अपलोड जरूरी हैं।