Rivya AI دستاویزات
ماڈل API صفحات

Kling V2.1 Standard API انضمام

Kling V2.1 Standard کو Rivya Public API v1 کے ذریعے ماڈل ID kling-v2-1-standard، معاون اِن پٹس، پیرامیٹرز، Files API قواعد، کریڈٹس اور جواب کی مثالوں کے ساتھ استعمال کریں۔

API کے ذریعے دستیابتیاریویڈیو
API ماڈل ID

kling-v2-1-standard

اِن پٹس

file

Files API

حوالہ جاتی طریقوں کے لیے ضروری

بنیادی کریڈٹس

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

صلاحیت

ویڈیو

بلنگ

FIXED

پرامپٹ کی حد

5000 حروف

درخواست کا معاہدہ

`model` ID کو بالائی سطح پر بھیجیں۔ ماڈل کے مخصوص کنٹرولز `params` میں رہتے ہیں۔

کلیدقسمضروریطے شدہوضاحت
modelstringہاںkling-v2-1-standardAPI ماڈل ID کے طور پر kling-v2-1-standard استعمال کریں۔
promptstringہاں-اس ماڈل کے لیے زیادہ سے زیادہ 5000 حروف۔
paramsobjectنہیں-ماڈل کا مخصوص پیرامیٹر آبجیکٹ۔ اجازت یافتہ کلیدوں کے لیے نیچے والی قطاریں دیکھیں۔
client_request_idstringنہیں-اپنے نظام میں درخواستوں کا سراغ رکھنے کے لیے اختیاری صارف طرفہ ID۔

ماڈل پیرامیٹرز

کلیدقسمضروریطے شدہحداختیاراتوضاحت
durationselectنہیں5-5, 10Duration
negative_prompttextنہیں---Negative prompt
cfg_scalenumberنہیں0.5min 0 / max 1 / step 0.1-یہ control کرتا ہے کہ result آپ کے prompt کو کتنی سختی سے follow کرے۔ Higher values عموما prompt کے قریب رہتی ہیں، مگر motion یا composition کو زیادہ stiff بھی بنا سکتی ہیں۔

اپ لوڈ پالیسی

حوالہ جاتی فائلیں پہلے اپ لوڈ کریں، پھر واپس ملنے والا URL اور دورانیے کا ٹوکن `params.referenceMediaItems` میں رکھیں۔

حوالے کا قاعدہ

Reference image: Image mode first frame کے طور پر 1 image file تک قبول کرتا ہے۔ JPEG/PNG ≤ 10 MB.

زیادہ سے زیادہ فائلیں

1

قبول شدہ فائل اقسام

image

دورانیے کا ٹوکن

دورانیے کی تصدیق ضروری ہو تو ویڈیو اور آڈیو حوالوں کو /api/v1/files سے ملنے والا `durationToken` ساتھ رکھنا چاہیے۔

kindزیادہ سے زیادہ حجمMIME اقسام
image10 MBimage/jpeg, image/png

کم سے کم درخواست

{
  "model": "kling-v2-1-standard",
  "params": {
    "duration": "5",
    "negative_prompt": "Describe کریں کہ video کو کن چیزوں سے بچنا چاہئے",
    "cfg_scale": 0.5
  }
}

حوالہ جاتی فائل کی درخواست

{
  "model": "kling-v2-1-standard",
  "params": {
    "duration": "5",
    "negative_prompt": "Describe کریں کہ video کو کن چیزوں سے بچنا چاہئے",
    "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_standard_example",
  "status": "queued",
  "model": "kling-v2-1-standard",
  "reserved_credits": 25,
  "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 حوالہ جاتی اپ لوڈز درکار ہوتے ہیں۔