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

Files

T

SnapOtter d24e244af4 docs: organize tool pages by modality under /tools/<modality>/

Move all 157 tool pages into image/video/audio/pdf/data subfolders so URLs read /tools/<modality>/<id> (e.g. /tools/image/crop). Nest the image sub-categories under an Image group in the sidebar so the nav reads by modality. Add public/_redirects (301, clean + .html forms) mapping every old flat /tools/<id> URL to its new path so inbound links keep working. Rewrite all internal /tools links. Verified with a clean docs build (no dead links).

2026-06-18 14:12:28 +08:00

2.5 KiB

Raw Blame History

description

description
Convert images between formats including modern formats like AVIF, JXL, and HEIC.

Convert

Convert images between formats. Supports common web formats as well as specialized formats like HEIC, JXL, BMP, ICO, JP2, QOI, and PSD.

API Endpoint

POST /api/v1/tools/image/convert

Accepts multipart form data with an image file and a JSON settings field.

Parameters

Parameter	Type	Required	Default	Description
format	string	Yes	-	Target format: `jpg`, `png`, `webp`, `avif`, `tiff`, `gif`, `heic`, `heif`, `jxl`, `bmp`, `ico`, `jp2`, `qoi`, `psd`
quality	number	No	-	Output quality (1-100). Applies to lossy formats like jpg, webp, avif, heic.

Supported Output Formats

Format	Type	Notes
jpg	Lossy	JPEG, best compatibility
png	Lossless	Supports transparency
webp	Both	Modern web format, good compression
avif	Lossy	Next-gen format, excellent compression
tiff	Both	Print/publishing workflows
gif	Lossless	Limited to 256 colors
heic / heif	Lossy	Apple ecosystem format
jxl	Both	JPEG XL, next-gen format
bmp	Lossless	Uncompressed bitmap
ico	Lossless	Windows icon format
jp2	Lossy	JPEG 2000
qoi	Lossless	Quite OK Image format
psd	Layered	Adobe Photoshop (requires ImageMagick)

Example Request

Convert to 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}'

Convert to PNG (lossless):

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

The output filename extension is automatically updated to match the target format.
SVG inputs are rasterized at 300 DPI before conversion.
PSD conversion requires ImageMagick to be installed on the server.
BMP, ICO, JP2, JXL, and QOI use specialized CLI encoders and bypass Sharp processing.
HEIC/HEIF encoding uses the system HEIC encoder library.
Input formats are broad: JPEG, PNG, WebP, AVIF, TIFF, GIF, HEIC, RAW (CR2, NEF, ARW, etc.), PSD, SVG, BMP, and more.

2.5 KiB Raw Blame History