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

2.3 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Recorta imágenes especificando una región con posición y dimensiones.	556f37893553	human	ac5e5e050598

Recortar imagen

Recorta imágenes definiendo una región rectangular mediante posición y tamaño. Admite unidades tanto de píxeles como de porcentaje.

Endpoint de la API

POST /api/v1/tools/image/crop

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

Parámetros

Parámetro	Tipo	Obligatorio	Predeterminado	Descripción
left	number	Sí	-	Desplazamiento X de la región de recorte (desde el borde izquierdo)
top	number	Sí	-	Desplazamiento Y de la región de recorte (desde el borde superior)
width	number	Sí	-	Ancho de la región de recorte
height	number	Sí	-	Alto de la región de recorte
unit	string	No	`"px"`	Unidad para los valores: `px` o `percent`

Ejemplo de solicitud

curl -X POST http://localhost:1349/api/v1/tools/image/crop \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"left": 100, "top": 50, "width": 800, "height": 600}'

Recortar usando valores de porcentaje:

curl -X POST http://localhost:1349/api/v1/tools/image/crop \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"left": 10, "top": 10, "width": 80, "height": 80, "unit": "percent"}'

Ejemplo de respuesta

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

Notas

La región de recorte debe caber dentro de los límites de la imagen. Si la región se extiende más allá de la imagen, la solicitud fallará.
Al usar la unidad percent, los valores representan porcentajes de las dimensiones de la imagen (p. ej. left: 10 significa 10 % desde el borde izquierdo).
El formato de salida coincide con el formato de entrada.
La orientación EXIF se aplica automáticamente antes del recorte, por lo que las coordenadas corresponden a la orientación visualmente correcta.

2.3 KiB Raw Blame History