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
संदर्भ मोड के लिए जरूरी
per_video · 720p_5=60 · 720p_10=120 · 1080p_5=100 · 1080p_10=200 · ⌈total⌉
वीडियो
FIXED
800 अक्षर
रिक्वेस्ट संरचना
मॉडल ID को शीर्ष स्तर पर भेजें। मॉडल के लिए खास कंट्रोल `params` में रखें।
| कुंजी | प्रकार | जरूरी | डिफॉल्ट | विवरण |
|---|---|---|---|---|
| model | string | हां | wan-2-5-video | wan-2-5-video API मॉडल ID का उपयोग करें। |
| prompt | string | हां | - | इस मॉडल के लिए अधिकतम 800 अक्षर। |
| params | object | नहीं | - | मॉडल के लिए खास पैरामीटर ऑब्जेक्ट। अनुमत कुंजियों के लिए नीचे दी गई पंक्तियां देखें। |
| client_request_id | string | नहीं | - | अपने सिस्टम में रिक्वेस्ट ट्रेस करने के लिए वैकल्पिक क्लाइंट-साइड ID। |
मॉडल पैरामीटर
| कुंजी | प्रकार | जरूरी | डिफॉल्ट | सीमा | विकल्प | विवरण |
|---|---|---|---|---|---|---|
| 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 | क्योंकि Wan 2.5 ऐसी short clips के लिए है जो पहले से fairly directed हैं। जब आप same shot की variations compare कर रहे हों, seed आपको repeatable option के करीब रखता है, negative prompt common failure modes हटाने में मदद करता है, और prompt expansion आपको decide करने देता है कि literal रहना है या model को elaborate करने देना है। Clip सिर्फ 5 या 10 seconds का हो, तब भी direction specific होने पर यह combination useful है। |
| seed | number | नहीं | - | min 0 / max 2147483647 | - | हर बार नया यादृच्छिक नतीजा पाने के लिए इसे खाली छोड़ें। वही पूर्णांक दोबारा इस्तेमाल करने से पिछले नतीजे को दोहराना या बारीक समायोजित करना आसान होता है। नतीजा तभी ज्यादा करीब रहता है जब प्रॉम्प्ट और बाकी मुख्य सेटिंग भी मिलती-जुलती रहें; फिर भी यह 1:1 मिलान की गारंटी नहीं है। |
| negative_prompt | text | नहीं | - | - | - | Negative prompt field |
अपलोड नीति
पहले संदर्भ फाइल अपलोड करें, फिर लौटे हुए URL और `durationToken` को `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."
}
}संदर्भ फाइल रिक्वेस्ट
{
"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.",
"referenceMediaItems": [
{
"url": "https://cdn.example.com/reference-image.png",
"kind": "image",
"name": "reference-image.png",
"mimeType": "image/png"
}
]
}
}निर्माण की प्रतिक्रिया
कार्य बनाने वाला एंडपॉइंट सार्वजनिक टास्क ID लौटाता है। टास्क सफल या विफल होने तक स्टेटस एंडपॉइंट पोल करें।
{
"id": "task_wan_2_5_video_example",
"status": "queued",
"model": "wan-2-5-video",
"reserved_credits": 60,
"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 संदर्भ अपलोड जरूरी हैं।
