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

Kling V2.1 Pro API इंटीग्रेशन

Rivya Public API v1 के जरिए मॉडल ID kling-v2-1-pro, समर्थित इनपुट, पैरामीटर, Files API नियम, क्रेडिट और रिस्पॉन्स उदाहरणों के साथ Kling V2.1 Pro का उपयोग करें।

API से उपलब्धउपलब्धता स्थितिवीडियो
API मॉडल ID

kling-v2-1-pro

इनपुट

file

Files API

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

बेस क्रेडिट

per_video · 5s=50 · 10s=100 · ⌈total⌉

क्षमता

वीडियो

बिलिंग

FIXED

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

5000 अक्षर

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

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

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

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

कुंजीप्रकारजरूरीडिफॉल्टसीमाविकल्पविवरण
durationselectनहीं5-5, 10अवधि
negative_prompttextनहीं---नकारात्मक prompt
cfg_scalenumberनहीं0.5min 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

`durationToken`

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

kindअधिकतम आकारMIME प्रकार
image10 MBimage/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 संदर्भ अपलोड जरूरी हैं।