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

API से उपलब्धटेक्स्ट या URL तैयार; संदर्भ मोड में Files API का उपयोग होता हैवीडियो

API मॉडल ID

kling-3-turbo

इनपुट

text, file

Files API

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

बेस क्रेडिट

per_output_second · 720p=18 · 1080p=22.5 · ⌈total⌉

क्षमता

वीडियो

बिलिंग

METERED

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

2500 अक्षर

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

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

कुंजी	प्रकार	जरूरी	डिफॉल्ट	विवरण
model	string	हां	kling-3-turbo	kling-3-turbo API मॉडल ID का उपयोग करें।
prompt	string	हां	-	इस मॉडल के लिए अधिकतम 2500 अक्षर।
params	object	नहीं	-	मॉडल के लिए खास पैरामीटर ऑब्जेक्ट। अनुमत key के लिए नीचे दी गई पंक्तियां देखें।
client_request_id	string	नहीं	-	अपने सिस्टम में रिक्वेस्ट ट्रेस करने के लिए वैकल्पिक क्लाइंट-साइड ID।

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

कुंजी	प्रकार	जरूरी	डिफॉल्ट	सीमा	विकल्प	विवरण
resolution	select	नहीं	720p	-	720p, 1080p	चुना गया रिज़ॉल्यूशन प्रति आउटपुट सेकंड की क्रेडिट दर भी तय करता है।
duration	number	नहीं	5	min 3 / max 15 / step 1	-	3 से 15 सेकंड तक की पूर्णांक आउटपुट अवधि चुनें।
aspect_ratio	select	नहीं	16:9	-	1:1, 9:16, 16:9	केवल टेक्स्ट-टू-वीडियो के लिए उपलब्ध; एक इमेज इस्तेमाल होने पर यह नियंत्रण छिपा रहता है।

अपलोड नीति

पहले संदर्भ फाइल अपलोड करें, फिर लौटे हुए URL और durationToken को params.referenceMediaItems में रखें।

संदर्भ नियम

वैकल्पिक शुरुआती इमेज: इमेज-टू-वीडियो के लिए अधिकतम 10 MB की ठीक एक JPEG या PNG इमेज अपलोड करें। टेक्स्ट-टू-वीडियो में कोई मीडिया अपलोड नहीं होता।

अधिकतम फाइलें

स्वीकार्य फाइल प्रकार

image

durationToken

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

kind	अधिकतम आकार	MIME प्रकार
image	10 MB	image/jpeg, image/png

न्यूनतम रिक्वेस्ट

{
  "model": "kling-3-turbo",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }
}

संदर्भ फाइल रिक्वेस्ट

{
  "model": "kling-3-turbo",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      }
    ]
  }
}

Create रिस्पॉन्स

create एंडपॉइंट सार्वजनिक टास्क ID लौटाता है। टास्क सफल या विफल होने तक स्टेटस एंडपॉइंट पोल करें।

{
  "id": "task_kling_3_turbo_example",
  "status": "queued",
  "model": "kling-3-turbo",
  "reserved_credits": 90,
  "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 संदर्भ अपलोड जरूरी हैं।

Kling 3.0 Turbo API इंटीग्रेशन