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

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

API मॉडल id

nano-banana-2

इनपुट

text, file

Files API

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

बेस क्रेडिट

क्षमता

इमेज

बिलिंग

FIXED

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

20000 अक्षर

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

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

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

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

Key	प्रकार	जरूरी	डिफॉल्ट	सीमा	विकल्प	विवरण
aspect_ratio	select	नहीं	auto	-	auto, 1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 21:9, 4:1, 1:4, 8:1, 1:8	आस्पेक्ट रेशियो
resolution	select	नहीं	1K	-	1K, 2K, 4K	रिजॉल्यूशन
output_format	select	नहीं	jpg	-	jpg, png	आउटपुट format
google_search	select	नहीं	false	-	false, true	Google Search grounding

अपलोड नीति

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

संदर्भ नियम

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

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

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

image

अवधि token

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

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

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

{
  "model": "nano-banana-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "auto",
    "resolution": "1K",
    "output_format": "jpg",
    "google_search": "false"
  }
}

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

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

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

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

{
  "id": "task_nano_banana_2_example",
  "status": "queued",
  "model": "nano-banana-2",
  "reserved_credits": 5,
  "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 2 API इंटीग्रेशन