ایڈوانسڈ پلان خصوصی 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"

درخواست کے پیرامیٹرز

پیرامیٹر	قسم	ضروری	تفصیل
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
#   }
# }

خرابی کوڈ کی وضاحت

حالت کوڈ	تفصیل
400	ضروری پیرامیٹرز غائب یا پیرامیٹر توثیق ناکام
401	API ٹوکن غلط، غائب یا خراب شکل میں
403	اکاؤنٹ غیر فعال، ایڈوانسڈ پلان کی سبسکرائب نہیں یا API اجازت نہیں
413	فائل کا سائز حد سے تجاوز (100MB)
429	شرح حد سے تجاوز (فی منٹ حد سے تجاوز)
495	ناکافی کریڈٹس
500	سرور اندرونی خرابی یا تصویر تخلیق ناکام

بہترین طریقے

API ٹوکن کو محفوظ رکھیں

اپنے API ٹوکن کو دوسروں کے ساتھ شیئر نہ کریں یا کوڈ ریپوزٹری میں ظاہر نہ کریں

خرابی کی ہینڈلنگ نافذ کریں

تمام ممکنہ خرابی کوڈز کو سنبھالیں، خاص طور پر 429 (شرح حد) اور 495 (ناکافی کریڈٹس)

شرح حد ہیڈرز کی نگرانی کریں

باقی کوٹہ سمجھنے کے لیے جوابی ہیڈرز میں X-RateLimit-Remaining چیک کریں

دوبارہ کوشش کا طریقہ کار نافذ کریں

429 خرابیوں کے لیے، Retry-After ہیڈر کی بنیاد پر exponential backoff retry نافذ کریں

ہدایات کو بہتر بنائیں

واضح، مخصوص ہدایات بہتر تخلیق کے نتائج دیتی ہیں

تصاویر کو کمپریس کریں

اپ لوڈ سے پہلے تصاویر کو کمپریس کرنے سے منتقلی کی رفتار بہتر ہوتی ہے اور بینڈوڈتھ بچتی ہے

API شرح حد

API کالز شرح حد سے محفوظ ہیں، حدود سبسکرپشن پلان کے مطابق مختلف ہوتی ہیں:

年

سالانہ ایڈوانسڈ پلان

200 درخواستیں/منٹ

月

ماہانہ ایڈوانسڈ پلان

20 درخواستیں/منٹ

💡جوابی ہیڈرز میں X-RateLimit-Limit، X-RateLimit-Remaining اور X-RateLimit-Reset معلومات شامل ہوں گی