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

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

API मॉडल ID

minimax-h3

इनपुट

text, file

Files API

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

बेस क्रेडिट

per_input_and_output_second · 768P=16 · 2K=26 · additional_image_after_five=8 · ⌈total⌉

क्षमता

वीडियो

बिलिंग

METERED

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

7000 अक्षर

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

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

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

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

कुंजी	प्रकार	जरूरी	डिफॉल्ट	सीमा	विकल्प	विवरण
seedance_scene	select	नहीं	text	-	text, frames, reference	अपलोड से पहले MiniMax इनपुट तरीका चुनें; टेक्स्ट, फ्रेम और रेफरेंस की अलग आवश्यकताएँ हैं।
resolution	select	नहीं	2K	-	768P, 2K	चुना गया स्तर आउटपुट और सत्यापित इनपुट-वीडियो समय पर लागू प्रति-सेकंड दर तय करता है।
aspect_ratio	select	नहीं	16:9	-	adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16	अनुकूली विकल्प रेफरेंस मोड में उपलब्ध है, टेक्स्ट मोड में नहीं। फ्रेम मोड यह नियंत्रण भेजने की जगह अपनी इमेज की ज्यामिति इस्तेमाल करता है।
minimax_single_frame_role	select	नहीं	first	-	first, last	हाँ। एक इमेज के साथ चुनें कि वह शुरुआती फ्रेम है या अंतिम। दो इमेज के साथ उन्हें पहले आरंभ और फिर अंत के क्रम में रखें।
duration	number	नहीं	6	min 4 / max 15 / step 1	-	4 से 15 सेकंड तक की पूर्णांक आउटपुट अवधि चुनें।

अपलोड नीति

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

संदर्भ नियम

मार्गदर्शक फ्रेम या बहुमाध्यमी रेफरेंस: फ्रेम दृश्य अधिकतम 30 MB की 1 या 2 JPEG, PNG या WebP इमेज स्वीकार करता है। रेफरेंस दृश्य ऐसी अधिकतम 9 इमेज, 50 MB और 2-15 सेकंड तक के 3 MP4/MOV वीडियो तथा 15 MB और 2-15 सेकंड तक की 3 MP3/WAV ऑडियो फ़ाइलें स्वीकार करता है; वीडियो और ऑडियो की कुल अवधि अपने-अपने मीडिया प्रकार के लिए 15 सेकंड, सभी मीडिया कुल 15 फ़ाइलों तक सीमित हैं और ऑडियो अकेले इस्तेमाल नहीं किया जा सकता।

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

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

image, video, audio

durationToken

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

kind	अधिकतम आकार	MIME प्रकार
image	30 MB	image/jpeg, image/png, image/webp
video	50 MB	video/mp4, video/quicktime
audio	15 MB	audio/mpeg, audio/wav, audio/x-wav

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

{
  "model": "minimax-h3",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "text",
    "resolution": "2K",
    "aspect_ratio": "16:9",
    "minimax_single_frame_role": "first",
    "duration": 6
  }
}

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

{
  "model": "minimax-h3",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "reference",
    "resolution": "2K",
    "aspect_ratio": "16:9",
    "minimax_single_frame_role": "first",
    "duration": 6,
    "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",
        "width": 1280,
        "height": 720,
        "sizeBytes": 8388608,
        "framesPerSecond": 30,
        "videoBitrateMbps": 8,
        "videoMetadataToken": "video_metadata_token_from_original_files_api_upload_response"
      }
    ]
  }
}

Create रिस्पॉन्स

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

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

MiniMax H3 API इंटीग्रेशन