Flux Kontext Max کو Rivya Public API v1 کے ذریعے ماڈل ID flux-kontext-max، معاون اِن پٹس، پیرامیٹرز، Files API قواعد، کریڈٹس اور جواب کی مثالوں کے ساتھ استعمال کریں۔

API کے ذریعے دستیابمتن یا URL تیار؛ حوالہ جاتی طریقے Files API استعمال کرتے ہیںتصویر

API ماڈل ID

flux-kontext-max

اِن پٹس

text, file

Files API

حوالہ جاتی طریقوں کے لیے ضروری

بنیادی کریڈٹس

per_image · default=8 · ⌈total⌉

صلاحیت

تصویر

بلنگ

FIXED

پرامپٹ کی حد

پرامپٹ کی کوئی دستاویزی حد نہیں

درخواست کا معاہدہ

`model` ID کو بالائی سطح پر بھیجیں۔ ماڈل کے مخصوص کنٹرولز `params` میں رہتے ہیں۔

کلید	قسم	ضروری	طے شدہ	وضاحت
model	string	ہاں	flux-kontext-max	API ماڈل ID کے طور پر flux-kontext-max استعمال کریں۔
prompt	string	ہاں	-	متنی اِن پٹ کی معاونت کرنے والے ماڈلز کے لیے پرامپٹ متن۔
params	object	نہیں	-	ماڈل کا مخصوص پیرامیٹر آبجیکٹ۔ اجازت یافتہ کلیدوں کے لیے نیچے والی قطاریں دیکھیں۔
client_request_id	string	نہیں	-	اپنے نظام میں درخواستوں کا سراغ رکھنے کے لیے اختیاری صارف طرفہ ID۔

ماڈل پیرامیٹرز

کلید	قسم	ضروری	طے شدہ	حد	اختیارات	وضاحت
aspectRatio	select	نہیں	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	پہلو کا تناسب
outputFormat	select	نہیں	jpeg	-	jpeg, png	JPEG چھوٹا ہوتا ہے، جبکہ PNG transparency یا cleaner lossless edges کے لیے بہتر ہے۔
enableTranslation	select	نہیں	true	-	true, false	Prompt auto-translate کریں
promptUpsampling	select	نہیں	false	-	false, true	فعال ہونے پر Rivya generation سے پہلے model کو آپ کا prompt expand اور polish کرنے دیتا ہے۔ یہ اکثر detail quality میں مدد کرتا ہے، مگر result کو raw prompt سے زیادہ interpretive بھی بنا سکتا ہے۔
safetyTolerance	number	نہیں	2	min 0 / max 6	-	یہ control کرتا ہے کہ content moderation کتنی strict ہو۔ Generation عموماً editing سے wider range allow کرتی ہے؛ lower values زیادہ strict اور higher values زیادہ permissive ہوتے ہیں۔
watermark	text	نہیں	-	-	-	واٹرمارک

اپ لوڈ پالیسی

حوالہ جاتی فائلیں پہلے اپ لوڈ کریں، پھر واپس ملنے والا URL اور دورانیے کا ٹوکن `params.referenceMediaItems` میں رکھیں۔

حوالے کا قاعدہ

حوالہ تصویر: image editing projects کے لیے 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": "اختیاری واٹرمارک متن"
  }
}

حوالہ جاتی فائل کی درخواست

{
  "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": "اختیاری واٹرمارک متن",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

تخلیقی جواب

تخلیقی اینڈ پوائنٹ عوامی کام کی ID واپس کرتا ہے۔ کام کے کامیاب یا ناکام ہونے تک حالت والے اینڈ پوائنٹ سے جانچتے رہیں۔

{
  "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 انضمام