एडवांस्ड प्लान विशिष्ट API

ViNano AI API

शक्तिशाली AI इमेज जनरेशन REST API, इसे कुछ ही पंक्तियों के कोड में अपने ऐप में एकीकृत करें

API उपयोग आवश्यकताएं

एडवांस्ड प्लान की सदस्यता आवश्यक
वार्षिक योजना उपयोगकर्ता: 200 अनुरोध/मिनट रेट लिमिट
मासिक योजना उपयोगकर्ता: 20 अनुरोध/मिनट रेट लिमिट

✉️

अधिक उन्नत API सुविधाओं की आवश्यकता है?

यदि आपको उच्च रेट लिमिट, एंटरप्राइज़ सहायता या कस्टम सुविधाओं की आवश्यकता है, तो कृपया ईमेल करें:

[email protected]

Skills और एकीकरण गाइड

API एकीकरण गाइड, कोड उदाहरण और ViNano AI API के सर्वोत्तम अभ्यास खोजें

GitHub पर देखें

क्या उम्मीद करें

उन डेवलपर्स के लिए बनाया गया जिन्हें बड़े पैमाने पर इमेज प्रोसेसिंग चाहिए

⚡

बिजली जैसी गति

हमारे अनुकूलित API इन्फ्रास्ट्रक्चर से मिलीसेकंड में इमेज प्रोसेस करें

🔧

आसान एकीकरण

विस्तृत दस्तावेज़ और बहुभाषी SDK के साथ RESTful API

💰

लचीला मूल्य निर्धारण

जो उपयोग करें उसी का भुगतान करें – पारदर्शी और डेवलपर-फ्रेंडली मूल्य

API कॉल निर्देश

इमेज जनरेशन के लिए ViNano AI API का उपयोग कैसे करें जानें

त्वरित शुरुआत

कुछ ही पंक्तियों के कोड में AI इमेज जनरेशन एकीकृत करें

API एंडपॉइंट

POST https://vinano.ai/api/v2/images/generate

curl -X POST https://vinano.ai/api/v2/images/generate \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "prompt=a beautiful sunset over the ocean" \
  -F "model=gemini-2.5-flash-image-preview" \
  -F "aspectRatio=16:9" \
  -F "googleSearch=false" \
  -F "mode=txt2img"

अनुरोध पैरामीटर

पैरामीटर	प्रकार	आवश्यक	डेवलपर्स के लिए शक्तिशाली इमेज एडिटिंग API। प्राकृतिक भाषा से मिलीसेकंड में इमेज बदलें।
prompt	string	No*	इमेज जनरेशन प्रॉम्प्ट (अधिकतम 2000 वर्ण)
image	File / File[]	No*	अपलोड की गई इमेज फ़ाइल(एं) (एकाधिक समर्थित)
imageUrl	string / string[]	No*	Existing image URL(s) (supports multiple URLs)
model	string	No	AI मॉडल, gemini-2.5-flash-image-preview, sora_image समर्थित
aspectRatio	string	No	पक्षानुपात, उदा. 1:1, 16:9, 9:16
mode	string	No	वैकल्पिक जेनरेशन मोड, जैसे photo_restoration (पुरानी फोटो मरम्मत), figure, meme आदि सभी मोड देखें
hdPro	boolean	No	HD मोड का उपयोग करना है या नहीं (30 क्रेडिट खर्च होते हैं, सामान्य मोड 10 क्रेडिट)
img_size	string	No	इमेज साइज: 1k, 2k, 4k (केवल gemini-3-pro-image-preview मॉडल, क्रेडिट: 1k=30, 2k=50, 4k=80)
googleSearch	boolean	No	Google खोज वृद्धि सक्षम करें (केवल gemini-3.1-pro-image-preview मॉडल द्वारा समर्थित, डिफ़ॉल्ट false)

* prompt या image में से कम से कम एक प्रदान किया जाना चाहिए

समर्थित मॉडल

gemini-2.5-flash-image-preview- Nano Banana (डिफ़ॉल्ट)
gemini-3.1-pro-image-preview- Nano Banana 2 (विस्तारित अनुपात 4:1, 1:4, 8:1, 1:8 समर्थित)
gemini-3-pro-image-preview- Nano Banana Pro
sora_image- GPT-Image 2
Seedance-5.0- Seedance 5.0 (केवल 2K/3K, टेक्स्ट→इमेज और इमेज→इमेज, वेब खोज समर्थित)
Z-Image- ViNano Basic (Z-Image, केवल टेक्स्ट→इमेज)

पूरी कीमत देखें →

प्रतिक्रिया प्रारूप

सफल प्रतिक्रिया (200)

{
  "status": 200,
  "images": ["https://example.com/generated-image.jpg"],
  "imageDetails": [{
    "width": 1024,
    "height": 1024,
    "filesize": 524288
  }],
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "prompt": "a beautiful sunset",
  "model": "gemini-2.5-flash-image-preview",
  "credits": {
    "cost": 10
  }
}

⚡ असिंक्रोनस इमेज जनरेशन API

एक टास्क सबमिट करें और task_id प्राप्त करें, फिर जनरेशन पूरा होने तक स्टेटस एंडपॉइंट को पोल करें।

चरण 1 — असिंक्रोनस टास्क सबमिट करें

POST https://vinano.ai/api/v1/images/async

चरण 2 — टास्क स्टेटस पोल करें

GET https://vinano.ai/api/v1/images/task-status?task_id={task_id}

# Step 1: Submit async task (same parameters as sync API)
curl -X POST "https://vinano.ai/api/v1/images/async" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "prompt=a beautiful sunset" \
  -F "model=gemini-2.5-flash-image-preview"

# Response (202):
# {
#   "status": 202,
#   "task_id": "550e8400-e29b-41d4-a716-446655440000",
#   "message": "Task submitted. Use GET /api/v1/images/task-status?task_id={task_id} to poll for results.",
#   "model": "gemini-2.5-flash-image-preview",
#   "credits": { "cost": 10 }
# }

# Step 2: Poll task status (repeat every 3-5s until status=200)
curl -X GET "https://vinano.ai/api/v1/images/task-status?task_id=550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_TOKEN"

# Response when completed:
# {
#   "status": 200,
#   "images": ["https://example.com/generated-image.jpg"],
#   "imageDetails": [{
#     "width": 1024,
#     "height": 1024,
#     "filesize": 524288
#   }],
#   "uuid": "550e8400-e29b-41d4-a716-446655440000",
#   "prompt": "a beautiful sunset",
#   "model": "gemini-2.5-flash-image-preview",
#   "credits": {
#     "cost": 10
#   }
# }

त्रुटि कोड स्पष्टीकरण

स्थिति कोड	डेवलपर्स के लिए शक्तिशाली इमेज एडिटिंग API। प्राकृतिक भाषा से मिलीसेकंड में इमेज बदलें।
400	आवश्यक पैरामीटर गायब या पैरामीटर सत्यापन विफल
401	API टोकन अमान्य, गायब या गलत रूप में
403	Account disabled, not subscribed to Advanced plan or no API permission
413	फ़ाइल का आकार सीमा से अधिक (100MB)
429	रेट लिमिट पार हो गई (प्रति मिनट सीमा पार हो गई)
495	अपर्याप्त क्रेडिट
500	सर्वर आंतरिक त्रुटि या इमेज जनरेशन विफल

सर्वोत्तम प्रथाएं

API टोकन को सुरक्षित रखें

अपने API टोकन को दूसरों के साथ साझा न करें या कोड रिपॉजिटरी में उजागर न करें

त्रुटि हैंडलिंग लागू करें

सभी संभावित त्रुटि कोड संभालें, विशेष रूप से 429 (रेट लिमिट) और 495 (अपर्याप्त क्रेडिट)

रेट लिमिट हेडर की निगरानी करें

शेष कोटा समझने के लिए रिस्पॉन्स हेडर में X-RateLimit-Remaining जांचें

पुनः प्रयास तंत्र लागू करें

429 त्रुटियों के लिए, Retry-After हेडर के आधार पर एक्सपोनेंशियल बैकऑफ रीट्राई लागू करें

प्रॉम्प्ट को अनुकूलित करें

स्पष्ट, विशिष्ट प्रॉम्प्ट बेहतर जनरेशन परिणाम देते हैं

इमेज को कंप्रेस करें

अपलोड से पहले इमेज को कंप्रेस करने से ट्रांसफर स्पीड में सुधार होता है और बैंडविड्थ बचती है

API रेट लिमिट

API कॉल रेट लिमिटिंग द्वारा सुरक्षित हैं, सीमाएं सदस्यता योजना के अनुसार भिन्न होती हैं:

年

वार्षिक एडवांस्ड प्लान

200 अनुरोध/मिनट

月

मासिक एडवांस्ड प्लान

20 अनुरोध/मिनट

💡रिस्पॉन्स हेडर में X-RateLimit-Limit, X-RateLimit-Remaining और X-RateLimit-Reset जानकारी शामिल होगी