Rivya AI ডকস
মডেল API পেজ

Kling V2.1 Master API ইন্টিগ্রেশন

Rivya Public API v1 দিয়ে Kling V2.1 Master ব্যবহার করুন: মডেল আইডি kling-v2-1-master, সমর্থিত ইনপুট, প্যারামিটার, Files API-র নিয়ম, ক্রেডিট ও উত্তরের উদাহরণসহ।

API দিয়ে উপলভ্যটেক্সট বা URL প্রস্তুত; রেফারেন্স মোডে Files API ব্যবহার করা হয়ভিডিও
API মডেল আইডি

kling-v2-1-master

ইনপুট

text, file

Files API

রেফারেন্স মোডের জন্য প্রয়োজন

বেস ক্রেডিট

per_video · 5s=160 · 10s=320 · ⌈total⌉

ক্ষমতা

ভিডিও

বিলিং

FIXED

প্রম্পট সীমা

5000 অক্ষর

অনুরোধের চুক্তি

মডেল আইডি শীর্ষ স্তরে পাঠান। মডেল-নির্দিষ্ট নিয়ন্ত্রণ params-এ থাকবে।

কীধরনপ্রয়োজনীয়ডিফল্টবিবরণ
modelstringহ্যাঁkling-v2-1-masterkling-v2-1-master API মডেল আইডি ব্যবহার করুন।
promptstringহ্যাঁ-এই মডেলের জন্য সর্বোচ্চ 5000 অক্ষর।
paramsobjectনা-মডেল-নির্দিষ্ট প্যারামিটার অবজেক্ট। অনুমোদিত key-গুলোর জন্য নিচের সারি দেখুন।
client_request_idstringনা-আপনার সিস্টেমে অনুরোধ শনাক্ত করার ঐচ্ছিক ক্লায়েন্ট-পক্ষের আইডি।

মডেল প্যারামিটার

কীধরনপ্রয়োজনীয়ডিফল্টপরিসরবিকল্পবিবরণ
durationselectনা5-5, 10সময়কাল
aspect_ratioselectনা16:9-16:9, 9:16, 1:1Aspect ratio
negative_prompttextনা---Negative prompt
cfg_scalenumberনা0.5min 0 / max 1 / step 0.1-result আপনার prompt কতটা tightভাবে follow করবে তা control করে। higher value সাধারণত prompt-এর কাছাকাছি থাকে, কিন্তু motion বা composition stiff লাগতে পারে।

আপলোড নীতি

প্রথমে রেফারেন্স ফাইল আপলোড করুন, তারপর পাওয়া URL ও দৈর্ঘ্যের টোকেন `params.referenceMediaItems`-এর মধ্যে দিন।

রেফারেন্স নিয়ম

Reference image: image-to-video mode-এ যেতে optionalভাবে একটি image upload করুন; text mode-এ থাকতে খালি রাখুন। JPEG/PNG ≤ 10 MB.

সর্বোচ্চ ফাইল

1

সমর্থিত ফাইল ধরন

image

দৈর্ঘ্যের টোকেন

দৈর্ঘ্য যাচাইয়ের প্রয়োজন হলে ভিডিও ও অডিও রেফারেন্স `/api/v1/files` থেকে durationToken বহন করবে।

kindসর্বোচ্চ আকারMIME ধরন
image10 MBimage/jpeg, image/png

ন্যূনতম অনুরোধ

{
  "model": "kling-v2-1-master",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "video যা এড়াবে তা বর্ণনা করুন",
    "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 যা এড়াবে তা বর্ণনা করুন",
    "cfg_scale": 0.5,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

জেনারেশন তৈরির উত্তর

জেনারেশন তৈরির এন্ডপয়েন্ট উন্মুক্ত কাজের আইডি ফেরত দেয়। কাজটি `succeeded` বা `failed` না হওয়া পর্যন্ত স্ট্যাটাস এন্ডপয়েন্ট পরীক্ষা করুন।

{
  "id": "task_kling_v2_1_master_example",
  "status": "queued",
  "model": "kling-v2-1-master",
  "reserved_credits": 160,
  "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-তে রেফারেন্স আপলোড করতে হয়।