API Documentation.
Integrate ImageFree.

RESTful API for background removal, image resizing, filters, and more.

Base URL: https://image-free.com

AUTH POST https://image-free.com/api/auth/signup

Create a new user account.

Body (JSON):
{ "email": "user@example.com", "password": "SecurePass123!", "name": "User Name" }
Example:
curl -X POST https://image-free.com/api/auth/signup -H "Content-Type: application/json" -d '{"email":"user@example.com","password":"SecurePass123!","name":"User Name"}'
AUTH POST https://image-free.com/api/auth/login

Log in and receive a JWT token.

Body (JSON):
{ "email": "user@example.com", "password": "SecurePass123!" }
Response:
{ "token": "eyJhbGciOiJIUzI1NiIs...", "user": { "email": "user@example.com", "name": "User Name" } }
Example:
curl -X POST https://image-free.com/api/auth/login -H "Content-Type: application/json" -d '{"email":"user@example.com","password":"SecurePass123!"}'
FREE POST https://image-free.com/api/remove-bg

Remove background from an image using AI (silueta model). Returns a transparent PNG.

Parameters (multipart/form-data):
{ "image": "(file) JPG, PNG, WebP — max 20MB" }
Response:
{ "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "url": "https://image-free.com/api/output/a1b2c3d4-e5f6-7890-abcd-ef1234567890.png" }
Example:
curl -X POST https://image-free.com/api/remove-bg -F "image=@portrait.jpg"
FREE POST https://image-free.com/api/background-blur

Blur the background while keeping the subject sharp. Uses AI subject detection.

Parameters (multipart/form-data):
{ "image": "(file) Image to process", "blurRadius": "(int) 1–30, default 10" }
Response:
{ "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901", "url": "https://image-free.com/api/output/b2c3d4e5-f6a7-8901-bcde-f12345678901.png" }
Example:
curl -X POST https://image-free.com/api/background-blur -F "image=@portrait.jpg" -F "blurRadius=15"
FREE POST https://image-free.com/api/selfie-filter

Apply filter presets to images. Presets: glow, warm, vintage, bw-classic, soft-glam, vivid, cool, dramatic, noir, golden, pastel, retro, cinematic, dreamy.

Parameters (multipart/form-data):
{ "image": "(file) Image to process", "preset": "(string) Filter preset name" }
Response:
{ "id": "c3d4e5f6-a7b8-9012-cdef-123456789012", "url": "https://image-free.com/api/output/c3d4e5f6-a7b8-9012-cdef-123456789012.png" }
Example:
curl -X POST https://image-free.com/api/selfie-filter -F "image=@portrait.jpg" -F "preset=glow"
AUTH POST https://image-free.com/api/compose

Compose a transparent foreground over a background with optional text overlay.

Parameters (JSON):
{
  "foregroundId": "(string) ID from /api/remove-bg",
  "bgType": "(string) solid | gradient | url",
  "bgColor": "(string, optional) hex color for solid bg",
  "gradientColors": "(array, optional) [\"#hex1\", \"#hex2\", ...]",
  "gradientDirection": "(string, optional) right | top | diagonal",
  "bgUrl": "(string, optional) background image URL",
  "text": "(string, optional) overlay text",
  "textColor": "(string, optional) hex, default #ffffff",
  "textSize": "(int, optional) 8–300, default 48",
  "textRotation": "(int, optional) 0–360",
  "textX": "(int, optional) horizontal offset",
  "textY": "(int, optional) vertical offset"
}
Example:
curl -X POST https://image-free.com/api/compose -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." -H "Content-Type: application/json" -d '{"foregroundId":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","bgType":"gradient","gradientColors":["#ff7e5f","#feb47b"],"text":"Summer Sale"}'
FREE POST https://image-free.com/api/store-image

Upload an image and get a shareable URL (stored 24h).

Parameters (multipart/form-data):
{ "image": "(file) Image file, max 20MB" }
Response:
{ "id": "d4e5f6a7-b8c9-0123-defa-234567890123", "url": "https://image-free.com/api/output/d4e5f6a7-b8c9-0123-defa-234567890123.png" }
Example:
curl -X POST https://image-free.com/api/store-image -F "image=@portrait.jpg"
FREE GET https://image-free.com/api/output/:filename

Retrieve a processed image by filename.

Parameter:
{ "filename": "(string) e.g. \"a1b2c3d4-e5f6-7890-abcd-ef1234567890.png\"" }
Example:
curl https://image-free.com/api/output/a1b2c3d4-e5f6-7890-abcd-ef1234567890.png --output result.png
FREE GET https://image-free.com/api/auth/me

Get current authenticated user info. Requires Bearer token.

Example:
curl https://image-free.com/api/auth/me -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
All endpoints return JSON. Auth-required endpoints return 401 if token is missing or invalid.