Kling V2.1 Pro API इंटीग्रेशन
Rivya Public API v1 के जरिए मॉडल ID kling-v2-1-pro, समर्थित इनपुट, पैरामीटर, Files API नियम, क्रेडिट और रिस्पॉन्स उदाहरणों के साथ Kling V2.1 Pro का उपयोग करें।
kling-v2-1-pro
file
संदर्भ मोड के लिए जरूरी
per_video · 5s=50 · 10s=100 · ⌈total⌉
वीडियो
FIXED
5000 अक्षर
रिक्वेस्ट संरचना
मॉडल ID को शीर्ष स्तर पर भेजें। मॉडल के लिए खास कंट्रोल `params` में रखें।
| कुंजी | प्रकार | जरूरी | डिफॉल्ट | विवरण |
|---|---|---|---|---|
| model | string | हां | kling-v2-1-pro | kling-v2-1-pro API मॉडल ID का उपयोग करें। |
| prompt | string | हां | - | इस मॉडल के लिए अधिकतम 5000 अक्षर। |
| params | object | नहीं | - | मॉडल के लिए खास पैरामीटर ऑब्जेक्ट। अनुमत कुंजियों के लिए नीचे दी गई पंक्तियां देखें। |
| client_request_id | string | नहीं | - | अपने सिस्टम में रिक्वेस्ट ट्रेस करने के लिए वैकल्पिक क्लाइंट-साइड ID। |
मॉडल पैरामीटर
| कुंजी | प्रकार | जरूरी | डिफॉल्ट | सीमा | विकल्प | विवरण |
|---|---|---|---|---|---|---|
| duration | select | नहीं | 5 | - | 5, 10 | अवधि |
| negative_prompt | text | नहीं | - | - | - | नकारात्मक prompt |
| cfg_scale | number | नहीं | 0.5 | min 0 / max 1 / step 0.1 | - | यह control करता है कि result आपके prompt को कितनी सख्ती से follow करे। Higher values आम तौर पर prompt के करीब रहते हैं, लेकिन motion या composition को stiffer भी बना सकते हैं। |
अपलोड नीति
पहले संदर्भ फाइल अपलोड करें, फिर लौटे हुए URL और `durationToken` को `params.referenceMediaItems` में रखें।
संदर्भ images: Image mode अधिकतम 2 image files स्वीकार करता है, और second image tail frame से map होती है। JPEG/PNG ≤ 10 MB.
2
image
अवधि सत्यापन जरूरी होने पर वीडियो और ऑडियो संदर्भों में /api/v1/files से मिला `durationToken` होना चाहिए।
| kind | अधिकतम आकार | MIME प्रकार |
|---|---|---|
| image | 10 MB | image/jpeg, image/png |
न्यूनतम रिक्वेस्ट
{
"model": "kling-v2-1-pro",
"params": {
"duration": "5",
"negative_prompt": "बताएं कि video को क्या avoid करना चाहिए",
"cfg_scale": 0.5
}
}संदर्भ फाइल रिक्वेस्ट
{
"model": "kling-v2-1-pro",
"params": {
"duration": "5",
"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"
}
]
}
}निर्माण की प्रतिक्रिया
कार्य बनाने वाला एंडपॉइंट सार्वजनिक टास्क ID लौटाता है। टास्क सफल या विफल होने तक स्टेटस एंडपॉइंट पोल करें।
{
"id": "task_kling_v2_1_pro_example",
"status": "queued",
"model": "kling-v2-1-pro",
"reserved_credits": 50,
"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 संदर्भ अपलोड जरूरी हैं।
