Files
SnapOtter/apps/docs/tr/tools/image/convert.md
T
SnapOtterandGitHub f858c4cea0 feat: clearer, disambiguated tool names across all surfaces (#520)
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.
2026-07-15 21:55:51 +08:00

3.2 KiB
Raw Blame History

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ı.