mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

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
Convertissez les images entre formats, y compris les formats modernes comme AVIF, JXL et HEIC.	562f8270e8c3	human	c2f8ce1ebb6a

Convertir

Convertissez les images entre formats. Prend en charge les formats web courants ainsi que les formats spécialisés comme HEIC, JXL, BMP, ICO, JP2, QOI et PSD.

API Endpoint

POST /api/v1/tools/image/convert

Accepte des données de formulaire multipart avec un fichier image et un champ JSON settings.

Parameters

Paramètre	Type	Requis	Défaut	Description
format	string	Oui	-	Format cible : `jpg`, `png`, `webp`, `avif`, `tiff`, `gif`, `heic`, `heif`, `jxl`, `bmp`, `ico`, `jp2`, `qoi`, `psd`, `ppm`, `eps`, `tga`
quality	number	Non	-	Qualité de sortie (1-100). S'applique aux formats avec perte comme jpg, webp, avif, heic.

Supported Output Formats

Format	Type	Remarques
jpg	Avec perte	JPEG, meilleure compatibilité
png	Sans perte	Prend en charge la transparence
webp	Les deux	Format web moderne, bonne compression
avif	Avec perte	Format nouvelle génération, excellente compression
tiff	Les deux	Flux de travail impression/édition
gif	Sans perte	Limité à 256 couleurs
heic / heif	Avec perte	Format de l'écosystème Apple
jxl	Les deux	JPEG XL, format nouvelle génération
bmp	Sans perte	Bitmap non compressé
ico	Sans perte	Format d'icône Windows
jp2	Avec perte	JPEG 2000
qoi	Sans perte	Format Quite OK Image
psd	En calques	Adobe Photoshop (nécessite ImageMagick)
ppm	Sans perte	Portable Pixmap (PPM/PGM/PBM)
eps	Vectoriel	Encapsulated PostScript
tga	Sans perte	Format d'image Targa

Example Request

Convertir en 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}'

Convertir en PNG (sans perte) :

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

L'extension du nom de fichier de sortie est automatiquement mise à jour pour correspondre au format cible.
Les entrées SVG sont rastérisées à 300 DPI avant la conversion.
La conversion PSD nécessite l'installation d'ImageMagick sur le serveur.
BMP, EPS, ICO, JP2, JXL, PPM, QOI et TGA utilisent des encodeurs CLI spécialisés et contournent le traitement Sharp.
L'encodage HEIC/HEIF utilise la bibliothèque d'encodage HEIC du système.
Les formats d'entrée sont larges : JPEG, PNG, WebP, AVIF, TIFF, GIF, HEIC, RAW (CR2, NEF, ARW, etc.), PSD, SVG, BMP et plus encore.

3.2 KiB Raw Blame History