इमेज रीसाइज़

सटीक पिक्सेल आयाम, एक प्रतिशत स्केल फ़ैक्टर, या एक फ़िट मोड निर्दिष्ट करके इमेज का आकार बदलें जो नियंत्रित करता है कि इमेज लक्ष्य आयामों के अनुकूल कैसे होती है।

API Endpoint

POST /api/v1/tools/image/resize

एक इमेज फ़ाइल और एक JSON settings फ़ील्ड के साथ multipart form data स्वीकार करता है।

Parameters

Parameter	Type	Required	Default	Description
width	integer	No	-	पिक्सेल में लक्ष्य चौड़ाई (अधिकतम 16383)
height	integer	No	-	पिक्सेल में लक्ष्य ऊँचाई (अधिकतम 16383)
fit	string	No	"contain"	इमेज आयामों में कैसे फ़िट होती है: contain, cover, fill, inside, outside
withoutEnlargement	boolean	No	false	यदि इमेज लक्ष्य से छोटी है तो अपस्केलिंग रोकें
percentage	number	No	-	प्रतिशत के अनुसार स्केल करें (उदा. आधे आकार के लिए 50)

width, height, या percentage में से कम से कम एक प्रदान किया जाना चाहिए।

Fit Modes

• contain - आस्पेक्ट अनुपात को संरक्षित करते हुए, आयामों के भीतर फ़िट करने के लिए आकार बदलें (खाली स्थान छोड़ सकता है)
• cover - आस्पेक्ट अनुपात को संरक्षित करते हुए, आयामों को कवर करने के लिए आकार बदलें (क्रॉप कर सकता है)
• fill - आयामों से बिल्कुल मेल खाने के लिए खींचें (आस्पेक्ट अनुपात को अनदेखा करता है)
• inside - contain की तरह, लेकिन केवल डाउनस्केल करता है, कभी अपस्केल नहीं
• outside - cover की तरह, लेकिन केवल डाउनस्केल करता है, कभी अपस्केल नहीं

Example Request

curl -X POST http://localhost:1349/api/v1/tools/image/resize \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F 'settings={"width": 800, "height": 600, "fit": "contain"}'

प्रतिशत के अनुसार आकार बदलें:

curl -X POST http://localhost:1349/api/v1/tools/image/resize \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F 'settings={"percentage": 50}'

Example Response

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.jpg",
  "originalSize": 2450000,
  "processedSize": 980000
}

Notes

• किसी भी अक्ष पर अधिकतम आयाम 16383 पिक्सेल है (Sharp/libvips सीमा)।
• आउटपुट प्रारूप इनपुट प्रारूप से मेल खाता है। HEIC, RAW, PSD और SVG इनपुट प्रोसेसिंग से पहले स्वतः डिकोड किए जाते हैं।
• आकार बदलने से पहले EXIF अभिविन्यास स्वतः लागू होता है।
• withoutEnlargement फ़्लैग बैच प्रोसेसिंग के लिए उपयोगी है जहाँ कुछ इमेज पहले से ही लक्ष्य से छोटी हो सकती हैं।