Rivya Public API v1 দিয়ে Flux Kontext Max ব্যবহার করুন: মডেল আইডি flux-kontext-max, সমর্থিত ইনপুট, প্যারামিটার, Files API-র নিয়ম, ক্রেডিট ও উত্তরের উদাহরণসহ।

API দিয়ে উপলভ্যটেক্সট বা URL প্রস্তুত; রেফারেন্স মোডে Files API ব্যবহার করা হয়ইমেজ

API মডেল আইডি

flux-kontext-max

ইনপুট

text, file

Files API

রেফারেন্স মোডের জন্য প্রয়োজন

বেস ক্রেডিট

per_image · default=8 · ⌈total⌉

ক্ষমতা

ইমেজ

বিলিং

FIXED

প্রম্পট সীমা

নথিভুক্ত প্রম্পট সীমা নেই

অনুরোধের চুক্তি

মডেল আইডি শীর্ষ স্তরে পাঠান। মডেল-নির্দিষ্ট নিয়ন্ত্রণ params-এ থাকবে।

কী	ধরন	প্রয়োজনীয়	ডিফল্ট	বিবরণ
model	string	হ্যাঁ	flux-kontext-max	flux-kontext-max API মডেল আইডি ব্যবহার করুন।
prompt	string	হ্যাঁ	-	টেক্সট ইনপুট সমর্থনকারী মডেলের প্রম্পট টেক্সট।
params	object	না	-	মডেল-নির্দিষ্ট প্যারামিটার অবজেক্ট। অনুমোদিত key-গুলোর জন্য নিচের সারি দেখুন।
client_request_id	string	না	-	আপনার সিস্টেমে অনুরোধ শনাক্ত করার ঐচ্ছিক ক্লায়েন্ট-পক্ষের আইডি।

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

কী	ধরন	প্রয়োজনীয়	ডিফল্ট	পরিসর	বিকল্প	বিবরণ
aspectRatio	select	না	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Aspect ratio
outputFormat	select	না	jpeg	-	jpeg, png	JPEG ছোট আকারের হয়, আর transparency বা পরিষ্কার lossless edge দরকার হলে PNG ভালো।
enableTranslation	select	না	true	-	true, false	Prompt auto-translate
promptUpsampling	select	না	false	-	false, true	Enabled হলে Rivya generation-এর আগে model-কে আপনার prompt expand ও polish করতে দেয়। এতে detail quality প্রায়ই ভালো হয়, তবে result raw prompt-এর চেয়ে বেশি interpretive হতে পারে।
safetyTolerance	number	না	2	min 0 / max 6	-	Content moderation কতটা strict হবে তা নিয়ন্ত্রণ করে। Generation সাধারণত editing-এর চেয়ে wider range allow করে; lower value বেশি strict এবং higher value বেশি permissive।
watermark	text	না	-	-	-	Watermark

আপলোড নীতি

প্রথমে রেফারেন্স ফাইল আপলোড করুন, তারপর পাওয়া URL ও দৈর্ঘ্যের টোকেন `params.referenceMediaItems`-এর মধ্যে দিন।

রেফারেন্স নিয়ম

Reference image: Image editing project-এর জন্য 1টি পর্যন্ত image file upload করুন।

সর্বোচ্চ ফাইল

সমর্থিত ফাইল ধরন

image

দৈর্ঘ্যের টোকেন

দৈর্ঘ্য যাচাইয়ের প্রয়োজন হলে ভিডিও ও অডিও রেফারেন্স `/api/v1/files` থেকে durationToken বহন করবে।

kind	সর্বোচ্চ আকার	MIME ধরন
image	10 MB	image/jpeg, image/png, image/webp

ন্যূনতম অনুরোধ

{
  "model": "flux-kontext-max",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "outputFormat": "jpeg",
    "enableTranslation": "true",
    "promptUpsampling": "false",
    "safetyTolerance": 2,
    "watermark": "Optional watermark text"
  }
}

রেফারেন্স ফাইল রিকোয়েস্ট

{
  "model": "flux-kontext-max",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "outputFormat": "jpeg",
    "enableTranslation": "true",
    "promptUpsampling": "false",
    "safetyTolerance": 2,
    "watermark": "Optional watermark text",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

জেনারেশন তৈরির উত্তর

জেনারেশন তৈরির এন্ডপয়েন্ট উন্মুক্ত কাজের আইডি ফেরত দেয়। কাজটি `succeeded` বা `failed` না হওয়া পর্যন্ত স্ট্যাটাস এন্ডপয়েন্ট পরীক্ষা করুন।

{
  "id": "task_flux_kontext_max_example",
  "status": "queued",
  "model": "flux-kontext-max",
  "reserved_credits": 8,
  "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-তে রেফারেন্স আপলোড করতে হয়।

Flux Kontext Max API ইন্টিগ্রেশন