Rivya AI दस्तावेज़
मॉडल API पेज

OmniHuman 1.5 API इंटीग्रेशन

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

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

omnihuman-1-5

इनपुट

file

Files API

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

बेस क्रेडिट

per_input_second · default=27 · ⌈total⌉

क्षमता

वीडियो

बिलिंग

METERED

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

300 अक्षर

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

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

कुंजीप्रकारजरूरीडिफॉल्टविवरण
modelstringहांomnihuman-1-5omnihuman-1-5 API मॉडल ID का उपयोग करें।
promptstringनहीं-इस मॉडल के लिए अधिकतम 300 अक्षर।
paramsobjectनहीं-मॉडल के लिए खास पैरामीटर ऑब्जेक्ट। अनुमत key के लिए नीचे दी गई पंक्तियां देखें।
client_request_idstringनहीं-अपने सिस्टम में रिक्वेस्ट ट्रेस करने के लिए वैकल्पिक क्लाइंट-साइड ID।

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

कुंजीप्रकारजरूरीडिफॉल्टसीमाविकल्पविवरण
output_resolutionselectनहीं1080-720, 1080आउटपुट रिज़ॉल्यूशन
pe_fast_modeselectनहींfalse-false, trueगुणवत्ता-प्रथम रन चुनें या गुणवत्ता में संभावित समझौते के साथ तेज़ प्रोसेसिंग को प्राथमिकता दें।
seednumberनहीं-1--हर बार नया यादृच्छिक नतीजा पाने के लिए इसे खाली छोड़ें। वही पूर्णांक दोबारा इस्तेमाल करने से पिछले नतीजे को दोहराना या बारीक समायोजित करना आसान होता है। नतीजा तभी ज्यादा करीब रहता है जब प्रॉम्प्ट और बाकी मुख्य सेटिंग भी मिलती-जुलती रहें; फिर भी यह 1:1 मिलान की गारंटी नहीं है।

अपलोड नीति

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

संदर्भ नियम

पोर्ट्रेट इमेज और ऑडियो: अधिकतम 10 MB का ठीक एक JPEG, PNG या WebP पोर्ट्रेट और अधिकतम 10 MB तथा 60 सेकंड से छोटा एक MP3, M4A, WAV, AAC या OGG ऑडियो अपलोड करें।

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

2

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

image, audio

durationToken

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

kindअधिकतम आकारMIME प्रकार
image10 MBimage/jpeg, image/png, image/webp
audio10 MBaudio/mpeg, audio/mp4, audio/wav, audio/x-wav, audio/aac, audio/ogg

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

{
  "model": "omnihuman-1-5",
  "params": {
    "output_resolution": "1080",
    "pe_fast_mode": "false",
    "seed": -1
  }
}

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

{
  "model": "omnihuman-1-5",
  "params": {
    "output_resolution": "1080",
    "pe_fast_mode": "false",
    "seed": -1,
    "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"
      },
      {
        "url": "https://cdn.example.com/reference-audio.wav",
        "kind": "audio",
        "name": "reference-audio.wav",
        "mimeType": "audio/wav",
        "durationSeconds": 12,
        "durationToken": "audio_duration_token_from_files_api"
      }
    ]
  }
}

Create रिस्पॉन्स

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

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