Rivya AI दस्तावेज़
मॉडल API पेज

Flux Kontext Pro API इंटीग्रेशन

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

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

flux-kontext-pro

इनपुट

text, file

Files API

संदर्भ mode के लिए जरूरी

बेस क्रेडिट

4

क्षमता

इमेज

बिलिंग

FIXED

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

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

रिक्वेस्ट अनुबंध

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

Keyप्रकारजरूरीडिफॉल्टविवरण
modelstringहांflux-kontext-proflux-kontext-pro API मॉडल id का उपयोग करें।
promptstringहां-टेक्स्ट इनपुट समर्थित मॉडल के लिए प्रॉम्प्ट टेक्स्ट।
paramsobjectनहीं-मॉडल के लिए खास पैरामीटर ऑब्जेक्ट। अनुमत keys के लिए नीचे दी गई पंक्तियां देखें।
client_request_idstringनहीं-अपने सिस्टम में रिक्वेस्ट ट्रेस करने के लिए वैकल्पिक client-side id।

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

Keyप्रकारजरूरीडिफॉल्टसीमाविकल्पविवरण
aspectRatioselectनहीं16:9-21:9, 16:9, 4:3, 1:1, 3:4, 9:16आस्पेक्ट रेशियो
outputFormatselectनहींjpeg-jpeg, pngJPEG छोटा होता है, जबकि PNG पारदर्शिता या साफ lossless किनारों के लिए बेहतर है।
enableTranslationselectनहींtrue-true, falseप्रॉम्प्ट अपने-आप अनुवाद करें
promptUpsamplingselectनहींfalse-false, trueचालू होने पर, Rivya जनरेशन से पहले मॉडल को आपका प्रॉम्प्ट विस्तार और निखारने देता है। इससे अक्सर विवरण की गुणवत्ता बेहतर होती है, लेकिन परिणाम आपके मूल प्रॉम्प्ट से अधिक व्याख्यात्मक भी हो सकता है।
safetyTolerancenumberनहीं2min 0 / max 6-यह तय करता है कि सामग्री नियंत्रण कितना सख्त हो। जनरेशन आम तौर पर एडिटिंग से अधिक व्यापक दायरा देता है; कम मान ज्यादा सख्त और अधिक मान ज्यादा उदार होते हैं।
watermarktextनहीं---वॉटरमार्क

अपलोड नीति

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

संदर्भ नियम

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

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

1

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

image

अवधि token

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

kindअधिकतम आकारMIME प्रकार
image10 MBimage/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 एंडपॉइंट सार्वजनिक टास्क 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

कुछ mode में Files API संदर्भ अपलोड जरूरी हैं।