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
Convierte imágenes entre formatos, incluidos formatos modernos como AVIF, JXL y HEIC.	2639f333073f	human	a306e06e0b7a

Convertir imagen

Convierte imágenes entre formatos. Admite formatos web comunes así como formatos especializados como HEIC, JXL, BMP, ICO, JP2, QOI y PSD.

Endpoint de la API

POST /api/v1/tools/image/convert

Acepta datos de formulario multipart con un archivo de imagen y un campo JSON settings.

Parámetros

Parámetro	Tipo	Obligatorio	Predeterminado	Descripción
format	string	Sí	-	Formato objetivo: `jpg`, `png`, `webp`, `avif`, `tiff`, `gif`, `heic`, `heif`, `jxl`, `bmp`, `ico`, `jp2`, `qoi`, `psd`, `ppm`, `eps`, `tga`
quality	number	No	-	Calidad de salida (1-100). Se aplica a formatos con pérdida como jpg, webp, avif, heic.

Formatos de salida admitidos

Formato	Tipo	Notas
jpg	Con pérdida	JPEG, la mejor compatibilidad
png	Sin pérdida	Admite transparencia
webp	Ambos	Formato web moderno, buena compresión
avif	Con pérdida	Formato de nueva generación, excelente compresión
tiff	Ambos	Flujos de trabajo de impresión/publicación
gif	Sin pérdida	Limitado a 256 colores
heic / heif	Con pérdida	Formato del ecosistema Apple
jxl	Ambos	JPEG XL, formato de nueva generación
bmp	Sin pérdida	Mapa de bits sin comprimir
ico	Sin pérdida	Formato de icono de Windows
jp2	Con pérdida	JPEG 2000
qoi	Sin pérdida	Formato Quite OK Image
psd	Por capas	Adobe Photoshop (requiere ImageMagick)
ppm	Sin pérdida	Portable Pixmap (PPM/PGM/PBM)
eps	Vectorial	Encapsulated PostScript
tga	Sin pérdida	Formato de imagen Targa

Ejemplo de solicitud

Convertir a 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 a PNG (sin pérdida):

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

Ejemplo de respuesta

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

Notas

La extensión del nombre del archivo de salida se actualiza automáticamente para coincidir con el formato objetivo.
Las entradas SVG se rasterizan a 300 DPI antes de la conversión.
La conversión a PSD requiere que ImageMagick esté instalado en el servidor.
BMP, EPS, ICO, JP2, JXL, PPM, QOI y TGA usan codificadores CLI especializados y omiten el procesamiento de Sharp.
La codificación HEIC/HEIF usa la biblioteca del codificador HEIC del sistema.
Los formatos de entrada son amplios: JPEG, PNG, WebP, AVIF, TIFF, GIF, HEIC, RAW (CR2, NEF, ARW, etc.), PSD, SVG, BMP y más.

3.2 KiB Raw Blame History