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

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

API मॉडल ID

hailuo-pro

इनपुट

text, file

Files API

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

बेस क्रेडिट

per_video · 1080P_6=57 · ⌈total⌉

क्षमता

वीडियो

बिलिंग

FIXED

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

1500 अक्षर

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

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

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

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

कुंजी	प्रकार	जरूरी	डिफॉल्ट	सीमा	विकल्प	विवरण
prompt_optimizer	select	नहीं	true	-	false, true	Hailuo को जनरेशन से पहले आपका प्रॉम्प्ट फिर से लिखने और अनुकूलित करने देता है। जब आप चाहते हैं कि रन आपके कच्चे शब्दों के करीब रहे, तो इसे बंद करें।
nsfw_checker	select	नहीं	true	-	false, true	कंटेंट filter

अपलोड नीति

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

संदर्भ नियम

संदर्भ इमेज: इमेज मोड अधिकतम 2 इमेज स्वीकार करता है, और दूसरी इमेज अंतिम फ्रेम बनती है। · JPG / PNG / WebP · ≤ 10 MB

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

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

image

`durationToken`

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

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

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

{
  "model": "hailuo-pro",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "prompt_optimizer": "true",
    "nsfw_checker": "true"
  }
}

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

{
  "model": "hailuo-pro",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "prompt_optimizer": "true",
    "nsfw_checker": "true",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

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

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

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

Hailuo Pro API इंटीग्रेशन