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

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

API मॉडल ID

flux-kontext-pro

इनपुट

text, file

Files API

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

बेस क्रेडिट

क्षमता

इमेज

बिलिंग

FIXED

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

प्रॉम्प्ट सीमा दर्ज नहीं है

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

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

कुंजी	प्रकार	जरूरी	डिफॉल्ट	विवरण
model	string	हां	flux-kontext-pro	flux-kontext-pro API मॉडल ID का उपयोग करें।
prompt	string	हां	-	टेक्स्ट इनपुट समर्थित मॉडल के लिए प्रॉम्प्ट टेक्स्ट।
params	object	नहीं	-	मॉडल के लिए खास पैरामीटर ऑब्जेक्ट। अनुमत key के लिए नीचे दी गई पंक्तियां देखें।
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 पारदर्शिता या साफ lossless किनारों के लिए बेहतर है।
enableTranslation	select	नहीं	true	-	true, false	प्रॉम्प्ट अपने-आप अनुवाद करें
promptUpsampling	select	नहीं	false	-	false, true	चालू होने पर, Rivya जनरेशन से पहले मॉडल को आपका प्रॉम्प्ट विस्तार और निखारने देता है। इससे अक्सर विवरण की गुणवत्ता बेहतर होती है, लेकिन परिणाम आपके मूल प्रॉम्प्ट से अधिक व्याख्यात्मक भी हो सकता है।
safetyTolerance	number	नहीं	2	min 0 / max 6	-	यह तय करता है कि सामग्री नियंत्रण कितना सख्त हो। जनरेशन आम तौर पर एडिटिंग से अधिक व्यापक दायरा देता है; कम मान ज्यादा सख्त और अधिक मान ज्यादा उदार होते हैं।
watermark	text	नहीं	-	-	-	वॉटरमार्क

अपलोड नीति

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

संदर्भ नियम

संदर्भ इमेज: इमेज एडिटिंग प्रोजेक्ट के लिए अधिकतम 1 इमेज फ़ाइल अपलोड करें।

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

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

image

durationToken

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

kind	अधिकतम आकार	MIME प्रकार
image	10 MB	image/jpeg, image/png, image/webp

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

{
  "model": "flux-kontext-pro",
  "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-pro",
  "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"
      }
    ]
  }
}

Create रिस्पॉन्स

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

{
  "id": "task_flux_kontext_pro_example",
  "status": "queued",
  "model": "flux-kontext-pro",
  "reserved_credits": 4,
  "final_credits": 0,
  "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 Pro API इंटीग्रेशन