Rivya Public API v1 দিয়ে Runway ব্যবহার করুন: মডেল আইডি runway, সমর্থিত ইনপুট, প্যারামিটার, Files API-র নিয়ম, ক্রেডিট ও উত্তরের উদাহরণসহ।

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

API মডেল আইডি

runway

ইনপুট

text, file

Files API

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

বেস ক্রেডিট

per_video · 720p_5s=12 · 720p_10s=30 · 1080p_5s=30 · ⌈total⌉

ক্ষমতা

ভিডিও

বিলিং

FIXED

প্রম্পট সীমা

1800 অক্ষর

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

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

কী	ধরন	প্রয়োজনীয়	ডিফল্ট	বিবরণ
model	string	হ্যাঁ	runway	runway API মডেল আইডি ব্যবহার করুন।
prompt	string	হ্যাঁ	-	এই মডেলের জন্য সর্বোচ্চ 1800 অক্ষর।
params	object	না	-	মডেল-নির্দিষ্ট প্যারামিটার অবজেক্ট। অনুমোদিত key-গুলোর জন্য নিচের সারি দেখুন।
client_request_id	string	না	-	আপনার সিস্টেমে অনুরোধ শনাক্ত করার ঐচ্ছিক ক্লায়েন্ট-পক্ষের আইডি।

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

কী	ধরন	প্রয়োজনীয়	ডিফল্ট	পরিসর	বিকল্প	বিবরণ
duration	select	না	5	-	5, 10	Duration
quality	select	না	720p	-	720p, 1080p	Quality
aspectRatio	select	না	16:9	-	16:9, 4:3, 1:1, 3:4, 9:16	Aspect ratio
waterMark	text	না	-	-	-	Watermark

আপলোড নীতি

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

রেফারেন্স নিয়ম

Reference image: image-to-video mode-এ যেতে optional 1টি image upload করুন; text mode-এ থাকতে empty রাখুন।

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

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

image

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

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

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

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

{
  "model": "runway",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": "5",
    "quality": "720p",
    "aspectRatio": "16:9",
    "waterMark": "watermark disable করতে empty রাখুন"
  }
}

রেফারেন্স ফাইল রিকোয়েস্ট

{
  "model": "runway",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": "5",
    "quality": "720p",
    "aspectRatio": "16:9",
    "waterMark": "watermark disable করতে empty রাখুন",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

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

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

{
  "id": "task_runway_example",
  "status": "queued",
  "model": "runway",
  "reserved_credits": 12,
  "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-তে রেফারেন্স আপলোড করতে হয়।

Runway API ইন্টিগ্রেশন