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

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

API मॉडल ID

hailuo-pro

इनपुट

text, file

Files API

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

बेस क्रेडिट

क्षमता

वीडियो

बिलिंग

FIXED

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

1500 अक्षर

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

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

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

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

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

अपलोड नीति

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

संदर्भ नियम

संदर्भ इमेज: इमेज मोड अधिकतम 2 इमेज स्वीकार करता है, और दूसरी इमेज अंतिम फ्रेम बनती है।

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

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

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": "false"
  }
}

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

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

Create रिस्पॉन्स

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

{
  "id": "task_hailuo_pro_example",
  "status": "queued",
  "model": "hailuo-pro",
  "reserved_credits": 57,
  "final_credits": 0,
  "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 इंटीग्रेशन