Files
SnapOtter/apps/docs/tr/tools/image/convert.md
T
SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages
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.
2026-07-11 13:52:47 +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. 562f8270e8c3 human 2ff55524f83b

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