mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
4.7 KiB
4.7 KiB
description, i18n_source_hash, i18n_provenance, i18n_output_hash
| description | i18n_source_hash | i18n_provenance | i18n_output_hash |
|---|---|---|---|
| AVIF, JXL, और HEIC जैसे आधुनिक फ़ॉर्मेट सहित छवियों को फ़ॉर्मेट के बीच परिवर्तित करें। | 562f8270e8c3 | human | d2a3deb5118b |
Convert
छवियों को फ़ॉर्मेट के बीच परिवर्तित करें। सामान्य वेब फ़ॉर्मेट के साथ-साथ HEIC, JXL, BMP, ICO, JP2, QOI, और PSD जैसे विशेष फ़ॉर्मेट का समर्थन करता है।
API Endpoint
POST /api/v1/tools/image/convert
एक छवि फ़ाइल और एक JSON settings फ़ील्ड के साथ मल्टीपार्ट फ़ॉर्म डेटा स्वीकार करता है।
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| format | string | Yes | - | लक्षित फ़ॉर्मेट: jpg, png, webp, avif, tiff, gif, heic, heif, jxl, bmp, ico, jp2, qoi, psd, ppm, eps, tga |
| quality | number | No | - | आउटपुट गुणवत्ता (1-100)। jpg, webp, avif, heic जैसे हानिकर फ़ॉर्मेट पर लागू होती है। |
Supported Output Formats
| Format | Type | Notes |
|---|---|---|
| jpg | Lossy | JPEG, सर्वोत्तम संगतता |
| png | Lossless | पारदर्शिता का समर्थन करता है |
| webp | Both | आधुनिक वेब फ़ॉर्मेट, अच्छा संपीड़न |
| avif | Lossy | अगली पीढ़ी का फ़ॉर्मेट, उत्कृष्ट संपीड़न |
| tiff | Both | प्रिंट/प्रकाशन वर्कफ़्लो |
| gif | Lossless | 256 रंगों तक सीमित |
| heic / heif | Lossy | Apple पारिस्थितिकी तंत्र फ़ॉर्मेट |
| jxl | Both | JPEG XL, अगली पीढ़ी का फ़ॉर्मेट |
| bmp | Lossless | असंपीड़ित बिटमैप |
| ico | Lossless | Windows आइकन फ़ॉर्मेट |
| jp2 | Lossy | JPEG 2000 |
| qoi | Lossless | Quite OK Image फ़ॉर्मेट |
| psd | Layered | Adobe Photoshop (ImageMagick आवश्यक) |
| ppm | Lossless | Portable Pixmap (PPM/PGM/PBM) |
| eps | Vector | Encapsulated PostScript |
| tga | Lossless | Targa छवि फ़ॉर्मेट |
Example Request
WebP में परिवर्तित करें:
curl -X POST http://localhost:1349/api/v1/tools/image/convert \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@photo.jpg" \
-F 'settings={"format": "webp", "quality": 85}'
PNG में परिवर्तित करें (हानिरहित):
curl -X POST http://localhost:1349/api/v1/tools/image/convert \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@photo.jpg" \
-F 'settings={"format": "png"}'
Example Response
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.webp",
"originalSize": 2450000,
"processedSize": 680000
}
Notes
- आउटपुट फ़ाइलनाम एक्सटेंशन स्वचालित रूप से लक्षित फ़ॉर्मेट से मेल खाने के लिए अद्यतन किया जाता है।
- SVG इनपुट परिवर्तन से पहले 300 DPI पर रैस्टराइज़ किए जाते हैं।
- PSD परिवर्तन के लिए सर्वर पर ImageMagick स्थापित होना आवश्यक है।
- BMP, EPS, ICO, JP2, JXL, PPM, QOI, और TGA विशेष CLI एन्कोडर का उपयोग करते हैं और Sharp प्रोसेसिंग को बायपास करते हैं।
- HEIC/HEIF एन्कोडिंग सिस्टम HEIC एन्कोडर लाइब्रेरी का उपयोग करती है।
- इनपुट फ़ॉर्मेट व्यापक हैं: JPEG, PNG, WebP, AVIF, TIFF, GIF, HEIC, RAW (CR2, NEF, ARW, आदि), PSD, SVG, BMP, और अधिक।