Kling V2.1 Master API इंटीग्रेशन
Rivya Public API v1 के जरिए मॉडल ID kling-v2-1-master, समर्थित इनपुट, पैरामीटर, Files API नियम, क्रेडिट और रिस्पॉन्स उदाहरणों के साथ Kling V2.1 Master का उपयोग करें।
kling-v2-1-master
text, file
संदर्भ मोड के लिए जरूरी
160
वीडियो
FIXED
5000 अक्षर
रिक्वेस्ट संरचना
मॉडल ID को शीर्ष स्तर पर भेजें। मॉडल के लिए खास कंट्रोल params में रखें।
| कुंजी | प्रकार | जरूरी | डिफॉल्ट | विवरण |
|---|---|---|---|---|
| model | string | हां | kling-v2-1-master | kling-v2-1-master API मॉडल ID का उपयोग करें। |
| prompt | string | हां | - | इस मॉडल के लिए अधिकतम 5000 अक्षर। |
| params | object | नहीं | - | मॉडल के लिए खास पैरामीटर ऑब्जेक्ट। अनुमत key के लिए नीचे दी गई पंक्तियां देखें। |
| client_request_id | string | नहीं | - | अपने सिस्टम में रिक्वेस्ट ट्रेस करने के लिए वैकल्पिक क्लाइंट-साइड ID। |
मॉडल पैरामीटर
| कुंजी | प्रकार | जरूरी | डिफॉल्ट | सीमा | विकल्प | विवरण |
|---|---|---|---|---|---|---|
| duration | select | नहीं | 5 | - | 5, 10 | अवधि |
| aspect_ratio | select | नहीं | 16:9 | - | 16:9, 9:16, 1:1 | आस्पेक्ट रेशियो |
| negative_prompt | text | नहीं | - | - | - | नकारात्मक prompt |
| cfg_scale | number | नहीं | 0.5 | min 0 / max 1 | - | यह control करता है कि result आपके prompt को कितनी सख्ती से follow करे। Higher values आम तौर पर prompt के करीब रहते हैं, लेकिन motion या composition को stiffer भी बना सकते हैं। |
अपलोड नीति
पहले संदर्भ फाइल अपलोड करें, फिर लौटे हुए URL और durationToken को params.referenceMediaItems में रखें।
Reference image: Image-to-video mode में switch करने के लिए optionally एक image upload करें; text mode में रहने के लिए इसे empty छोड़ें।
1
image
अवधि सत्यापन जरूरी होने पर वीडियो और ऑडियो संदर्भों में /api/v1/files से मिला durationToken होना चाहिए।
| kind | अधिकतम आकार | MIME प्रकार |
|---|---|---|
| image | 10 MB | image/jpeg, image/png, image/webp |
न्यूनतम रिक्वेस्ट
{
"model": "kling-v2-1-master",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"duration": "5",
"aspect_ratio": "16:9",
"negative_prompt": "बताएं कि video को क्या avoid करना चाहिए",
"cfg_scale": 0.5
}
}संदर्भ फाइल रिक्वेस्ट
{
"model": "kling-v2-1-master",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"duration": "5",
"aspect_ratio": "16:9",
"negative_prompt": "बताएं कि video को क्या avoid करना चाहिए",
"cfg_scale": 0.5,
"referenceMediaItems": [
{
"url": "https://cdn.example.com/reference-image.png",
"kind": "image",
"name": "reference-image.png",
"mimeType": "image/png"
}
]
}
}Create रिस्पॉन्स
create एंडपॉइंट सार्वजनिक टास्क ID लौटाता है। टास्क सफल या विफल होने तक स्टेटस एंडपॉइंट पोल करें।
{
"id": "task_kling_v2_1_master_example",
"status": "queued",
"model": "kling-v2-1-master",
"reserved_credits": 160,
"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 संदर्भ अपलोड जरूरी हैं।