mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
Renames 18 ambiguous or hard-to-search tool names so image tools self-qualify like the other modalities ("Compress" becomes "Compress Image"), and cleans up a few awkward names. Propagated across search (constants.ts), display (en.ts + 20 locales), the OpenAPI base spec + 20 locale specs, and the docs tool-page headings in 21 languages. Removes the duplicate "Normalize Audio" summary shared by the video and audio endpoints. Tool ids and routes are unchanged, so no API paths or bookmarks break.
3.2 KiB
3.2 KiB
description, i18n_source_hash, i18n_provenance, i18n_output_hash
| description | i18n_source_hash | i18n_provenance | i18n_output_hash |
|---|---|---|---|
| AVIF, JXL ve HEIC gibi modern biçimler dahil olmak üzere görüntüleri biçimler arasında dönüştürün. | 2639f333073f | human | 2ff55524f83b |
Görüntü Dönüştür
Görüntüleri biçimler arasında dönüştürün. HEIC, JXL, BMP, ICO, JP2, QOI ve PSD gibi özel biçimlerin yanı sıra yaygın web biçimlerini de destekler.
API Uç Noktası
POST /api/v1/tools/image/convert
Bir görüntü dosyası ve bir JSON settings alanı ile çok parçalı form verilerini kabul eder.
Parametreler
| Parametre | Tür | Zorunlu | Varsayılan | Açıklama |
|---|---|---|---|---|
| format | string | Evet | - | Hedef biçim: jpg, png, webp, avif, tiff, gif, heic, heif, jxl, bmp, ico, jp2, qoi, psd, ppm, eps, tga |
| quality | number | Hayır | - | Çıktı kalitesi (1-100). jpg, webp, avif, heic gibi kayıplı biçimlere uygulanır. |
Desteklenen Çıktı Biçimleri
| Biçim | Tür | Notlar |
|---|---|---|
| jpg | Kayıplı | JPEG, en iyi uyumluluk |
| png | Kayıpsız | Saydamlığı destekler |
| webp | Her ikisi | Modern web biçimi, iyi sıkıştırma |
| avif | Kayıplı | Yeni nesil biçim, mükemmel sıkıştırma |
| tiff | Her ikisi | Baskı/yayın iş akışları |
| gif | Kayıpsız | 256 renkle sınırlı |
| heic / heif | Kayıplı | Apple ekosistemi biçimi |
| jxl | Her ikisi | JPEG XL, yeni nesil biçim |
| bmp | Kayıpsız | Sıkıştırılmamış bit eşlem |
| ico | Kayıpsız | Windows simge biçimi |
| jp2 | Kayıplı | JPEG 2000 |
| qoi | Kayıpsız | Quite OK Image biçimi |
| psd | Katmanlı | Adobe Photoshop (ImageMagick gerektirir) |
| ppm | Kayıpsız | Portable Pixmap (PPM/PGM/PBM) |
| eps | Vektör | Encapsulated PostScript |
| tga | Kayıpsız | Targa görüntü biçimi |
Örnek İstek
WebP'ye dönüştür:
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'ye dönüştür (kayıpsız):
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"}'
Örnek Yanıt
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.webp",
"originalSize": 2450000,
"processedSize": 680000
}
Notlar
- Çıktı dosya adı uzantısı, hedef biçimle eşleşecek şekilde otomatik olarak güncellenir.
- SVG girişleri, dönüştürmeden önce 300 DPI'de rasterleştirilir.
- PSD dönüştürme, sunucuda ImageMagick'in kurulu olmasını gerektirir.
- BMP, EPS, ICO, JP2, JXL, PPM, QOI ve TGA, özel CLI kodlayıcıları kullanır ve Sharp işlemesini atlar.
- HEIC/HEIF kodlaması, sistem HEIC kodlayıcı kitaplığını kullanır.
- Giriş biçimleri geniştir: JPEG, PNG, WebP, AVIF, TIFF, GIF, HEIC, RAW (CR2, NEF, ARW, vb.), PSD, SVG, BMP ve daha fazlası.