API de ferramentas de imagem

Endpoints para compressao, redimensionamento, conversao, rotacao, recorte, remocao de fundo, ampliacao, desfoque de rosto e marca d'agua de imagens. Todos os endpoints aceitam multipart/form-data e retornam a imagem processada como arquivo binario.

Comprimir imagem

POST/api/image-compress

Comprima uma imagem para reduzir o tamanho do arquivo mantendo a qualidade visual. Suporta formatos JPEG, PNG e WebP.

Parameters

Name	Type	Required	Description
`file`	File	Required	Arquivo de imagem (JPG, PNG, WebP)
`quality`	number	Optional	Qualidade de compressao, 10-100. Padrao: 80
`targetSizeKB`	number	Optional	Tamanho alvo do arquivo em KB. Substitui a qualidade se definido.
`keepMetadata`	string	Optional	Defina como "true" para preservar metadados 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 imagem

POST/api/image-resize

Redimensione uma imagem para dimensoes especificas ou por porcentagem. Suporta dimensoes em pixels e escalonamento percentual.

Parameters

Name	Type	Required	Description
`file`	File	Required	Arquivo de imagem
`width`	number	Optional	Largura alvo em pixels
`height`	number	Optional	Altura alvo em pixels
`percentage`	number	Optional	Porcentagem de escala (ex. 50 para metade do tamanho)
`fit`	string	Optional	"inside" (manter proporcao) ou "fill" (esticar para dimensoes exatas)

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

Converter imagem

POST/api/image-convert

Converta uma imagem entre formatos. Suporta PNG, JPG, WebP e AVIF.

Parameters

Name	Type	Required	Description
`file`	File	Required	Arquivo de imagem
`format`	string	Required	Formato alvo: "png", "jpg", "webp" ou "avif"
`quality`	number	Optional	Qualidade de saida, 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

Rotacionar imagem

POST/api/image-rotate

Rotacione e/ou espelhe uma imagem. Suporta angulos de rotacao arbitrarios e espelhamento horizontal/vertical.

Parameters

Name	Type	Required	Description
`file`	File	Required	Arquivo de imagem
`angle`	number	Required	Angulo de rotacao em graus (ex. 90, 180, 270)
`flipH`	string	Optional	Defina como "true" para espelhar horizontalmente
`flipV`	string	Optional	Defina como "true" para espelhar 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 imagem

POST/api/image-crop

Recorte uma imagem para uma regiao retangular especifica.

Parameters

Name	Type	Required	Description
`file`	File	Required	Arquivo de imagem
`x`	number	Required	Deslocamento esquerdo do retangulo de recorte em pixels
`y`	number	Required	Deslocamento superior do retangulo de recorte em pixels
`width`	number	Required	Largura do retangulo de recorte em pixels
`height`	number	Required	Altura do retangulo de recorte em pixels

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

Remover fundo

POST/api/remove-bg

Remova automaticamente o fundo de uma imagem. Retorna um PNG com fundo transparente.

Parameters

Name	Type	Required	Description
`file`	File	Required	Arquivo de imagem

Response:Imagem PNG com fundo 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

Ampliar imagem

POST/api/image-upscale

Amplie uma imagem usando IA para aumentar a resolucao preservando detalhes.

Parameters

Name	Type	Required	Description
`file`	File	Required	Arquivo de imagem
`scale`	number	Optional	Fator de ampliacao: 2 ou 4. Padrao: 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

Desfocar rosto

POST/api/blur-face

Detecte e desfoque automaticamente todos os rostos em uma imagem para protecao de privacidade.

Parameters

Name	Type	Required	Description
`file`	File	Required	Arquivo de imagem

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 d'agua em imagem

POST/api/watermark-image

Adicione uma marca d'agua de texto a uma imagem. Personalize o texto e a posicao.

Parameters

Name	Type	Required	Description
`file`	File	Required	Arquivo de imagem
`text`	string	Required	Texto da marca d'agua
`position`	string	Optional	Posicao: "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