API de herramientas de imagen

Endpoints para compresion, redimensionamiento, conversion, rotacion, recorte, eliminacion de fondo, escalado, difuminado de rostros y marca de agua de imagenes. Todos los endpoints aceptan multipart/form-data y devuelven la imagen procesada como archivo binario.

Comprimir imagen

POST/api/image-compress

Comprime una imagen para reducir el tamano del archivo manteniendo la calidad visual. Soporta formatos JPEG, PNG y WebP.

Parameters

Name	Type	Required	Description
`file`	File	Required	Archivo de imagen (JPG, PNG, WebP)
`quality`	number	Optional	Calidad de compresion, 10-100. Por defecto: 80
`targetSizeKB`	number	Optional	Tamano de archivo objetivo en KB. Anula la calidad si se establece.
`keepMetadata`	string	Optional	Establece en "true" para preservar los metadatos EXIF

Response:Binary file

bash

curl -X POST https://freefiletools.io/api/image-compress \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "quality=75" \
  -o compressed.jpg

Redimensionar imagen

POST/api/image-resize

Redimensiona una imagen a dimensiones especificas o por porcentaje. Soporta dimensiones en pixeles y escalado por porcentaje.

Parameters

Name	Type	Required	Description
`file`	File	Required	Archivo de imagen
`width`	number	Optional	Ancho objetivo en pixeles
`height`	number	Optional	Alto objetivo en pixeles
`percentage`	number	Optional	Porcentaje de escala (ej. 50 para la mitad del tamano)
`fit`	string	Optional	"inside" (mantener relacion de aspecto) o "fill" (estirar a dimensiones exactas)

Response:Binary file

bash

# Resize to specific width (height auto-calculated)
curl -X POST https://freefiletools.io/api/image-resize \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "width=800" \
  -o resized.jpg

# Resize by percentage
curl -X POST https://freefiletools.io/api/image-resize \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "percentage=50" \
  -o resized.jpg

Convertir imagen

POST/api/image-convert

Convierte una imagen entre formatos. Soporta PNG, JPG, WebP y AVIF.

Parameters

Name	Type	Required	Description
`file`	File	Required	Archivo de imagen
`format`	string	Required	Formato objetivo: "png", "jpg", "webp" o "avif"
`quality`	number	Optional	Calidad de salida, 10-100

Response:Binary file

bash

curl -X POST https://freefiletools.io/api/image-convert \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "format=webp" \
  -F "quality=85" \
  -o photo.webp

Rotar imagen

POST/api/image-rotate

Rota y/o voltea una imagen. Soporta angulos de rotacion arbitrarios y volteo horizontal/vertical.

Parameters

Name	Type	Required	Description
`file`	File	Required	Archivo de imagen
`angle`	number	Required	Angulo de rotacion en grados (ej. 90, 180, 270)
`flipH`	string	Optional	Establece en "true" para voltear horizontalmente
`flipV`	string	Optional	Establece en "true" para voltear verticalmente

Response:Binary file

bash

curl -X POST https://freefiletools.io/api/image-rotate \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "angle=90" \
  -o rotated.jpg

Recortar imagen

POST/api/image-crop

Recorta una imagen a una region rectangular especifica.

Parameters

Name	Type	Required	Description
`file`	File	Required	Archivo de imagen
`x`	number	Required	Desplazamiento izquierdo del rectangulo de recorte en pixeles
`y`	number	Required	Desplazamiento superior del rectangulo de recorte en pixeles
`width`	number	Required	Ancho del rectangulo de recorte en pixeles
`height`	number	Required	Alto del rectangulo de recorte en pixeles

Response:Binary file

bash

curl -X POST https://freefiletools.io/api/image-crop \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "x=100" \
  -F "y=50" \
  -F "width=500" \
  -F "height=400" \
  -o cropped.jpg

Eliminar fondo

POST/api/remove-bg

Elimina automaticamente el fondo de una imagen. Devuelve un PNG con fondo transparente.

Parameters

Name	Type	Required	Description
`file`	File	Required	Archivo de imagen

Response:Imagen PNG con fondo transparente

bash

curl -X POST https://freefiletools.io/api/remove-bg \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -o no-background.png

Escalar imagen

POST/api/image-upscale

Escala una imagen usando IA para aumentar la resolucion preservando los detalles.

Parameters

Name	Type	Required	Description
`file`	File	Required	Archivo de imagen
`scale`	number	Optional	Factor de escalado: 2 o 4. Por defecto: 2

Response:Binary file

bash

curl -X POST https://freefiletools.io/api/image-upscale \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "scale=4" \
  -o upscaled.jpg

Difuminar rostro

POST/api/blur-face

Detecta y difumina automaticamente todos los rostros en una imagen para proteccion de privacidad.

Parameters

Name	Type	Required	Description
`file`	File	Required	Archivo de imagen

Response:Binary file

bash

curl -X POST https://freefiletools.io/api/blur-face \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -o blurred.jpg

Marca de agua en imagen

POST/api/watermark-image

Agrega una marca de agua de texto a una imagen. Personaliza el texto y la posicion.

Parameters

Name	Type	Required	Description
`file`	File	Required	Archivo de imagen
`text`	string	Required	Texto de marca de agua
`position`	string	Optional	Posicion: "center", "top-left", "top-right", "bottom-left", "bottom-right"

Response:Binary file

bash

curl -X POST https://freefiletools.io/api/watermark-image \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "text=Copyright 2024" \
  -F "position=bottom-right" \
  -o watermarked.jpg