Image Upscaling API: डेवलपर इंटीग्रेशन गाइड

अपने ऐप में इमेज अपस्केलिंग जोड़ने के लिए पहले खुद के AI मॉडल ट्रेन करने पड़ते थे। इसमें महीनों का समय और GPU का भारी बजट लगता था। UpscaleIMG API के साथ, आप एक इमेज भेजते हैं और कुछ ही सेकंड में शार्प, बड़ी की गई इमेज वापस पाते हैं।

यह गाइड आपको बताती है कि UpscaleIMG को अपने प्रोजेक्ट में कैसे इंटीग्रेट करें। असली कोड उदाहरण और सभी उपलब्ध विकल्प शामिल हैं।

UpscaleIMG API क्या कर सकता है?

UpscaleIMG API, Real-ESRGAN का उपयोग करता है। यह इमेज सुपर-रिज़ॉल्यूशन के लिए बना एक शक्तिशाली AI मॉडल है। आप फोटो भेजते हैं, और AI उसे बड़ा करते हुए असली जैसे बारीक डिटेल जोड़ता है। किनारे शार्प रहते हैं। टेक्सचर प्राकृतिक दिखते हैं। चेहरे की विशेषताएं भी बनी रहती हैं।

आपको क्या मिलता है:

• 2x और 4x अपस्केलिंग — AI आधारित डिटेल सुधार
• कस्टम आकार — अपनी ज़रूरत के अनुसार आउटपुट साइज़ सेट करें
• फॉर्मेट बदलाव — PNG, JPG और WebP के बीच कन्वर्ट करें
• मेटाडेटा नियंत्रण — EXIF डेटा हटाएं या रखें
• अधिकतम 64 मेगापिक्सल आउटपुट रिज़ॉल्यूशन

सारी AI प्रोसेसिंग हमारे सर्वर पर होती है। आपको GPU की ज़रूरत नहीं। मॉडल सेटअप की ज़रूरत नहीं। बस एक HTTP रिक्वेस्ट भेजें और रिज़ल्ट पाएं।

API कैसे शुरू करें?

रिक्वेस्ट भेजने के लिए API key ज़रूरी है। इसे कैसे पाएं:

1. upscaleimg.app पर अकाउंट बनाएं
2. डैशबोर्ड में जाकर API key जेनरेट करें
3. इसे अपने सर्वर पर सुरक्षित रखें

API एंडपॉइंट:

POST https://upscaleimg.app/api/v1/upscale

प्रमाणीकरण के लिए Authorization हेडर में Bearer टोकन का उपयोग होता है। API key को सर्वर साइड पर ही रखें। इसे क्लाइंट कोड में न दिखाएं और रिपॉज़िटरी में कमिट न करें।

मुफ़्त अकाउंट पर 2x अपस्केलिंग मिलती है। सब्सक्राइबर्स को 4x अपस्केलिंग और मूल आकार के 4 गुना तक कस्टम साइज़ की सुविधा मिलती है।

पहली इमेज को अपस्केल कैसे करें?

सबसे आसान कॉल में बस एक इमेज और स्केल फ़ैक्टर चाहिए। curl से 2x अपस्केलिंग का उदाहरण:

curl -X POST https://upscaleimg.app/api/v1/upscale \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "image=@photo.jpg" \
  -F "scale=2"

API मूल और अपस्केल की गई इमेज दोनों की जानकारी JSON में लौटाता है:

{
  "original": {
    "size": 384000,
    "width": 1920,
    "height": 1080,
    "mimeType": "image/jpeg",
    "fileExt": "jpg"
  },
  "result": {
    "size": 1280000,
    "width": 3840,
    "height": 2160,
    "mimeType": "image/png",
    "fileExt": "png",
    "url": "https://..."
  }
}

url फ़ील्ड में साइन किया हुआ डाउनलोड लिंक होता है। साइन किए गए URL जल्दी एक्सपायर होते हैं, इसलिए तुरंत डाउनलोड करें।

JavaScript में यही रिक्वेस्ट:

const form = new FormData();
form.append('image', fileInput.files[0]);
form.append('scale', '2');

const response = await fetch('https://upscaleimg.app/api/v1/upscale', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: form
});

const data = await response.json();
console.log(`${data.result.width}x${data.result.height} में बड़ा किया गया`);

Python में:

import requests

with open('photo.jpg', 'rb') as f:
    response = requests.post(
        'https://upscaleimg.app/api/v1/upscale',
        headers={'Authorization': 'Bearer YOUR_API_KEY'},
        files={'image': f},
        data={'scale': '2'}
    )

data = response.json()
print(f"{data['result']['width']}x{data['result']['height']} में बड़ा किया गया")

API में कौन से विकल्प उपलब्ध हैं?

API, multipart form data के ज़रिए कई पैरामीटर स्वीकार करता है। पूरी सूची:

पैरामीटर	आवश्यक	मान	विवरण
image	हां	फ़ाइल	PNG, JPG, JPEG या WebP इमेज
scale	हां*	2 या 4	अपस्केल फ़ैक्टर। *कस्टम आकार में ज़रूरत नहीं।
customWidth	नहीं	पूर्णांक	लक्ष्य चौड़ाई पिक्सल में (अधिकतम 4 गुना)
customHeight	नहीं	पूर्णांक	लक्ष्य ऊंचाई पिक्सल में (अधिकतम 4 गुना)
objectFit	नहीं	cover, contain, fill	कस्टम आकार में फ़िटिंग का तरीका। डिफ़ॉल्ट: cover।
outputFormat	नहीं	jpg, jpeg, png, webp	आउटपुट फॉर्मेट। डिफ़ॉल्ट: png।
removeMetadata	नहीं	1 या 0	EXIF डेटा हटाएं। डिफ़ॉल्ट: 0 (रखें)।

कस्टम आकार से आपको सटीक नियंत्रण मिलता है। customWidth और customHeight दोनों साथ में देने होते हैं। आउटपुट मूल इमेज से छोटा नहीं हो सकता और 4 गुना से बड़ा भी नहीं (मुफ़्त अकाउंट पर 2 गुना तक)।

उदाहरण के लिए, 3000x2000 WebP में अपस्केल करना:

curl -X POST https://upscaleimg.app/api/v1/upscale \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "image=@photo.jpg" \
  -F "customWidth=3000" \
  -F "customHeight=2000" \
  -F "objectFit=cover" \
  -F "outputFormat=webp" \
  -F "removeMetadata=1"

objectFit पैरामीटर CSS object-fit की तरह काम करता है। cover सटीक आकार में भरता है (कुछ हिस्सा कट सकता है)। contain आकार के अंदर फ़िट करता है (खाली जगह रह सकती है)। fill सटीक आकार में खींचता है।

एरर और रेट लिमिट कैसे संभालें?

API मानक HTTP स्टेटस कोड लौटाता है:

स्टेटस	अर्थ
200	सफल। अपस्केल की गई इमेज लौटाई गई।
400	गलत रिक्वेस्ट। इमेज नहीं मिली, गलत फ़ैक्टर, या आकार सीमा से बाहर।
401	API key गलत या मौजूद नहीं।
403	प्रतिबंधित। सब्सक्रिप्शन के बिना 4x की कोशिश या CORS एरर।
429	रेट लिमिट। बहुत ज़्यादा रिक्वेस्ट।
500	सर्वर एरर। दोबारा कोशिश करें।

सभी एरर रिस्पॉन्स में संदेश शामिल होता है:

{"error": "4x upscaling is only available with an active subscription."}

रेट लिमिट के लिए बैकऑफ़ के साथ रिट्राई लॉजिक जोड़ें:

async function upscaleWithRetry(form, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const res = await fetch('https://upscaleimg.app/api/v1/upscale', {
      method: 'POST',
      headers: { 'Authorization': 'Bearer YOUR_API_KEY' },
      body: form
    });

    if (res.status === 429) {
      await new Promise(r => setTimeout(r, 2000 * (i + 1)));
      continue;
    }

    return await res.json();
  }
  throw new Error('Max retries reached');
}

भेजने से पहले जांच भी करें। देखें कि फ़ाइल सही फॉर्मेट (PNG, JPG, WebP) में है। सुनिश्चित करें कि आउटपुट 64 मेगापिक्सल से ज़्यादा न हो।

सबसे अच्छे उपयोग कहां होते हैं?

UpscaleIMG API कई तरह के कामों में बहुत अच्छा फ़िट होता है।

ई-कॉमर्स प्लेटफ़ॉर्म पर विक्रेताओं की उत्पाद तस्वीरें सुधारने के लिए इसका उपयोग होता है। कई अपलोड छोटे या कम गुणवत्ता वाले होते हैं। स्वचालित अपस्केलिंग से हर लिस्टिंग पेशेवर दिखती है। बिना गुणवत्ता खोए इमेज बड़ी करना भी पढ़ें।

प्रिंट-ऑन-डिमांड सेवाओं को उच्च रिज़ॉल्यूशन फ़ाइलें चाहिए। ग्राहक ऐसी इमेज अपलोड करते हैं जो स्क्रीन पर अच्छी दिखती हैं लेकिन प्रिंट के लिए छोटी होती हैं। आप सीधे 4K तक अपस्केल भी कर सकते हैं।

फ़ोटो रिस्टोरेशन ऐप्स अपस्केलिंग को अन्य सुधारों के साथ जोड़ते हैं। पुरानी या धुंधली फ़ोटो को साफ़ करें और साथ ही बड़ा करें। API, AI का भारी काम संभालता है।

कंटेंट मैनेजमेंट सिस्टम अपलोड के समय इमेज को अपने आप बेहतर बना सकते हैं। इससे हर इमेज न्यूनतम गुणवत्ता मानक पर बनी रहती है।

रियल एस्टेट वेबसाइट पर एक समान फ़ोटो गुणवत्ता का फ़ायदा मिलता है। एजेंट अलग-अलग कैमरों से तस्वीरें लेते हैं। स्वचालित अपस्केलिंग सबको एक पेशेवर रूप देता है।

बैच प्रोसेसिंग के लिए इमेज अपस्केलिंग ऑटोमेट करने की गाइड देखें। सर्वश्रेष्ठ अपस्केलर की तुलना भी सहायक होगी।

शुरू करने के लिए तैयार हैं?

एक घंटे से भी कम में आपका इंटीग्रेशन तैयार हो जाएगा। upscaleimg.app पर अकाउंट बनाएं, API key लें, और अपनी पहली टेस्ट इमेज भेजें।

पहले 2x पर कुछ इमेज आज़माकर गुणवत्ता जांचें। संतुष्ट होने पर अपनी पाइपलाइन में जोड़ें। AI इमेज अपस्केलिंग की संपूर्ण गाइड में और भी बहुत कुछ जानने को मिलेगा।

मुफ़्त प्लान से परीक्षण और PoC बनाना काफ़ी है। जब 4x अपस्केलिंग और अधिक प्रोसेसिंग चाहिए, तब पेड प्लान पर जाएं।