Rivya Public API v1 দিয়ে MiniMax H3 ব্যবহার করুন: model id minimax-h3, সমর্থিত ইনপুট, প্যারামিটার, Files API নিয়ম, ক্রেডিট এবং response উদাহরণসহ।

API দিয়ে উপলভ্যটেক্সট বা URL প্রস্তুত; reference modes Files API ব্যবহার করেভিডিও

API model id

minimax-h3

ইনপুট

text, file

Files API

reference mode-এর জন্য প্রয়োজন

বেস ক্রেডিট

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

ক্ষমতা

ভিডিও

বিলিং

METERED

প্রম্পট সীমা

7000 অক্ষর

রিকোয়েস্ট contract

model id top level-এ পাঠান। Model-specific control params-এ থাকবে।

Key	ধরন	প্রয়োজনীয়	ডিফল্ট	বিবরণ
model	string	হ্যাঁ	minimax-h3	minimax-h3 API model id ব্যবহার করুন।
prompt	string	হ্যাঁ	-	এই model-এর জন্য সর্বোচ্চ 7000 অক্ষর।
params	object	না	-	মডেল-নির্দিষ্ট প্যারামিটার object। অনুমোদিত key-এর জন্য নিচের row ব্যবহার করুন।
client_request_id	string	না	-	আপনার সিস্টেমে request trace করার ঐচ্ছিক client-side id।

মডেল প্যারামিটার

Key	ধরন	প্রয়োজনীয়	ডিফল্ট	পরিসর	বিকল্প	বিবরণ
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 সেকেন্ডের পূর্ণসংখ্যা আউটপুট মেয়াদ বেছে নিন।

আপলোড নীতি

প্রথমে reference file upload করুন, তারপর ফেরত পাওয়া URL এবং duration token 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

Duration token

duration verification প্রয়োজন হলে video এবং audio reference /api/v1/files থেকে durationToken বহন করবে।

kind	সর্বোচ্চ আকার	MIME types
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

ন্যূনতম request

{
  "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 response

create endpoint public task id ফেরত দেয়। task succeeded বা failed না হওয়া পর্যন্ত status endpoint poll করুন।

{
  "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

কিছু mode-এর জন্য Files API reference upload দরকার।

MiniMax H3 API ইন্টিগ্রেশন