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

Convertir

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