Flux Kontext Pro API इंटीग्रेशन
Rivya Public API v1 के जरिए मॉडल id flux-kontext-pro, समर्थित इनपुट, पैरामीटर, Files API नियम, क्रेडिट और रिस्पॉन्स उदाहरणों के साथ Flux Kontext Pro का उपयोग करें।
flux-kontext-pro
text, file
संदर्भ mode के लिए जरूरी
4
इमेज
FIXED
प्रॉम्प्ट सीमा दर्ज नहीं है
रिक्वेस्ट अनुबंध
मॉडल id को शीर्ष स्तर पर भेजें। मॉडल के लिए खास कंट्रोल params में रखें।
| Key | प्रकार | जरूरी | डिफॉल्ट | विवरण |
|---|---|---|---|---|
| model | string | हां | flux-kontext-pro | flux-kontext-pro API मॉडल id का उपयोग करें। |
| prompt | string | हां | - | टेक्स्ट इनपुट समर्थित मॉडल के लिए प्रॉम्प्ट टेक्स्ट। |
| params | object | नहीं | - | मॉडल के लिए खास पैरामीटर ऑब्जेक्ट। अनुमत keys के लिए नीचे दी गई पंक्तियां देखें। |
| client_request_id | string | नहीं | - | अपने सिस्टम में रिक्वेस्ट ट्रेस करने के लिए वैकल्पिक client-side id। |
मॉडल पैरामीटर
| Key | प्रकार | जरूरी | डिफॉल्ट | सीमा | विकल्प | विवरण |
|---|---|---|---|---|---|---|
| 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 और duration token को params.referenceMediaItems में रखें।
संदर्भ इमेज: इमेज एडिटिंग प्रोजेक्ट के लिए अधिकतम 1 इमेज फ़ाइल अपलोड करें।
1
image
अवधि सत्यापन जरूरी होने पर वीडियो और ऑडियो संदर्भों में /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 एंडपॉइंट सार्वजनिक टास्क 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 संदर्भ अपलोड जरूरी हैं।