Rivya Public API v1 के जरिए मॉडल id gpt-image-2, समर्थित इनपुट, पैरामीटर, Files API नियम, क्रेडिट और रिस्पॉन्स उदाहरणों के साथ GPT Image 2 का उपयोग करें।

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

API मॉडल id

gpt-image-2

इनपुट

text, file

Files API

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

बेस क्रेडिट

क्षमता

इमेज

बिलिंग

FIXED

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

20000 अक्षर

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

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

Key	प्रकार	जरूरी	डिफॉल्ट	विवरण
model	string	हां	gpt-image-2	gpt-image-2 API मॉडल id का उपयोग करें।
prompt	string	हां	-	इस मॉडल के लिए अधिकतम 20000 अक्षर।
params	object	नहीं	-	मॉडल के लिए खास पैरामीटर ऑब्जेक्ट। अनुमत keys के लिए नीचे दी गई पंक्तियां देखें।
client_request_id	string	नहीं	-	अपने सिस्टम में रिक्वेस्ट ट्रेस करने के लिए वैकल्पिक client-side id।

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

Key	प्रकार	जरूरी	डिफॉल्ट	सीमा	विकल्प	विवरण
aspect_ratio	select	नहीं	1:1	-	auto, 1:1, 9:16, 16:9, 4:3, 3:4	आस्पेक्ट रेशियो
resolution	select	नहीं	1K	-	1K, 2K, 4K	रिजॉल्यूशन

अपलोड नीति

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

संदर्भ नियम

संदर्भ इमेज: GPT Image 2 इमेज-से-इमेज कार्यों के लिए अधिकतम 16 इमेज संदर्भ अपलोड करें।

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

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

image

अवधि token

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

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

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

{
  "model": "gpt-image-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "1K"
  }
}

संदर्भ फाइल रिक्वेस्ट

{
  "model": "gpt-image-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

रिस्पॉन्स बनाएं

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

{
  "id": "task_gpt_image_2_example",
  "status": "queued",
  "model": "gpt-image-2",
  "reserved_credits": 3,
  "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 संदर्भ अपलोड जरूरी हैं।

GPT Image 2 API इंटीग्रेशन