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

Files

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
Converti immagini tra formati, inclusi formati moderni come AVIF, JXL e HEIC.	2639f333073f	human	cc7a9af253e2

Converti Immagine

Converti immagini tra formati. Supporta i formati web comuni oltre a formati specializzati come HEIC, JXL, BMP, ICO, JP2, QOI e PSD.

Endpoint API

POST /api/v1/tools/image/convert

Accetta dati di form multipart con un file immagine e un campo JSON settings.

Parametri

Parametro	Tipo	Obbligatorio	Predefinito	Descrizione
format	string	Sì	-	Formato di destinazione: `jpg`, `png`, `webp`, `avif`, `tiff`, `gif`, `heic`, `heif`, `jxl`, `bmp`, `ico`, `jp2`, `qoi`, `psd`, `ppm`, `eps`, `tga`
quality	number	No	-	Qualità di output (1-100). Si applica ai formati con perdita come jpg, webp, avif, heic.

Formati di output supportati

Formato	Tipo	Note
jpg	Con perdita	JPEG, migliore compatibilità
png	Senza perdita	Supporta la trasparenza
webp	Entrambi	Formato web moderno, buona compressione
avif	Con perdita	Formato di nuova generazione, compressione eccellente
tiff	Entrambi	Flussi di lavoro per stampa/editoria
gif	Senza perdita	Limitato a 256 colori
heic / heif	Con perdita	Formato dell'ecosistema Apple
jxl	Entrambi	JPEG XL, formato di nuova generazione
bmp	Senza perdita	Bitmap non compressa
ico	Senza perdita	Formato icona di Windows
jp2	Con perdita	JPEG 2000
qoi	Senza perdita	Formato Quite OK Image
psd	A livelli	Adobe Photoshop (richiede ImageMagick)
ppm	Senza perdita	Portable Pixmap (PPM/PGM/PBM)
eps	Vettoriale	Encapsulated PostScript
tga	Senza perdita	Formato immagine Targa

Esempio di richiesta

Converti in 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}'

Converti in PNG (senza perdita):

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"}'

Esempio di risposta

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.webp",
  "originalSize": 2450000,
  "processedSize": 680000
}

Note

L'estensione del nome del file di output viene aggiornata automaticamente per corrispondere al formato di destinazione.
Gli input SVG vengono rasterizzati a 300 DPI prima della conversione.
La conversione PSD richiede che ImageMagick sia installato sul server.
BMP, EPS, ICO, JP2, JXL, PPM, QOI e TGA usano encoder CLI specializzati e bypassano l'elaborazione di Sharp.
La codifica HEIC/HEIF usa la libreria di codifica HEIC di sistema.
I formati di input sono ampi: JPEG, PNG, WebP, AVIF, TIFF, GIF, HEIC, RAW (CR2, NEF, ARW, ecc.), PSD, SVG, BMP e altri.

3.2 KiB Raw Blame History