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

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

API मॉडल id

nano-banana

इनपुट

text, file

Files API

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

बेस क्रेडिट

क्षमता

इमेज

बिलिंग

FIXED

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

5000 अक्षर

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

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

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

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

Key	प्रकार	जरूरी	डिफॉल्ट	सीमा	विकल्प	विवरण
imageSize	select	नहीं	1:1	-	1:1, 9:16, 16:9, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9, auto	इमेज size
output_format	select	नहीं	png	-	png, jpeg	आउटपुट format

अपलोड नीति

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

संदर्भ नियम

रेफरेंस इमेज: Image projects के लिए 10 image files तक upload करें।

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

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

image

अवधि token

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

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

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

{
  "model": "nano-banana",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "imageSize": "1:1",
    "output_format": "png"
  }
}

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

{
  "model": "nano-banana",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "imageSize": "1:1",
    "output_format": "png",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

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

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

{
  "id": "task_nano_banana_example",
  "status": "queued",
  "model": "nano-banana",
  "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 संदर्भ अपलोड जरूरी हैं।

Nano Banana API इंटीग्रेशन