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

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

API मॉडल ID

runway-aleph

इनपुट

file

Files API

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

बेस क्रेडिट

per_video · default=90 · ⌈total⌉

क्षमता

वीडियो

बिलिंग

FIXED

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

5000 अक्षर

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

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

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

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

कुंजी	प्रकार	जरूरी	डिफॉल्ट	सीमा	विकल्प	विवरण
aspectRatio	select	नहीं	16:9	-	16:9, 9:16, 4:3, 3:4, 1:1, 21:9	आस्पेक्ट रेशियो
waterMark	text	नहीं	-	-	-	वॉटरमार्क
seed	number	नहीं	-	-	-	हर बार नया यादृच्छिक नतीजा पाने के लिए इसे खाली छोड़ें। वही पूर्णांक दोबारा इस्तेमाल करने से पिछले नतीजे को दोहराना या बारीक समायोजित करना आसान होता है। नतीजा तभी ज्यादा करीब रहता है जब प्रॉम्प्ट और बाकी मुख्य सेटिंग भी मिलती-जुलती रहें; फिर भी यह 1:1 मिलान की गारंटी नहीं है।

अपलोड नीति

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

संदर्भ नियम

Input media स्रोत: वह source clip upload करें जिसे Aleph से transform कराना है। Extra style या subject guidance चाहिए हो तभी एक optional still image add करें।

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

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

video, image

`durationToken`

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

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

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

{
  "model": "runway-aleph",
  "params": {
    "aspectRatio": "16:9",
    "waterMark": "वॉटरमार्क disable करने के लिए खाली छोड़ें",
    "seed": 1
  }
}

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

{
  "model": "runway-aleph",
  "params": {
    "aspectRatio": "16:9",
    "waterMark": "वॉटरमार्क disable करने के लिए खाली छोड़ें",
    "seed": 1,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-video.mp4",
        "kind": "video",
        "name": "reference-video.mp4",
        "mimeType": "video/mp4",
        "durationSeconds": 8,
        "durationToken": "video_duration_token_from_files_api"
      }
    ]
  }
}

निर्माण की प्रतिक्रिया

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

{
  "id": "task_runway_aleph_example",
  "status": "queued",
  "model": "runway-aleph",
  "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 संदर्भ अपलोड जरूरी हैं।

Runway Aleph API इंटीग्रेशन