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

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

API मॉडल ID

happyhorse-1-1

इनपुट

text, file

Files API

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

बेस क्रेडिट

per_output_second · 720p=22.5 · 1080p=29 · ⌈total⌉

क्षमता

वीडियो

बिलिंग

METERED

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

5000 अक्षर

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

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

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

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

कुंजी	प्रकार	जरूरी	डिफॉल्ट	सीमा	विकल्प	विवरण
resolution	select	नहीं	1080p	-	720p, 1080p	चुना गया रिज़ॉल्यूशन प्रति-सेकंड क्रेडिट दर तय करता है।
aspect_ratio	select	नहीं	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9	केवल प्रॉम्प्ट और बहु-रेफरेंस रन में इस्तेमाल होता है; एकल-इमेज रन अपने पहले फ्रेम का अनुसरण करता है।
duration	number	नहीं	5	min 3 / max 15 / step 1	-	3 से 15 सेकंड तक की पूर्णांक आउटपुट अवधि चुनें।

अपलोड नीति

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

संदर्भ नियम

पहला फ्रेम या रेफरेंस इमेज: पहले-फ्रेम एनीमेशन के लिए एक JPEG, PNG या WebP इमेज अथवा रेफरेंस-आधारित वीडियो के लिए 2 से 9 इमेज अपलोड करें। हर फ़ाइल अधिकतम 20 MB की हो सकती है।

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

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

image

durationToken

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

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

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

{
  "model": "happyhorse-1-1",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5
  }
}

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

{
  "model": "happyhorse-1-1",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      }
    ]
  }
}

Create रिस्पॉन्स

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

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

HappyHorse 1.1 API इंटीग्रेशन