API Documentation

Authentication

Register and copy your API key from the account page, then send it in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Server operators may also configure shared keys in API_KEYS (comma-separated).

Health check. No authentication required.

curl https://getpictools.com/api/v1/health

Compress an image. Returns JSON with base64-encoded output.

Form fields

• file (required) — image file
• quality — 1–100, default 80
• format — jpeg | png | webp
• maxWidth, maxHeight — optional limits

curl -X POST https://getpictools.com/api/v1/compress \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "[email protected]" \
  -F "quality=75" \
  -F "format=webp"

Convert image format. Returns JSON with base64 output.

Form fields

• file (required)
• format — jpeg | png | webp, default webp
• quality — 1–100, default 85

curl -X POST https://getpictools.com/api/v1/convert \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "[email protected]" \
  -F "format=webp" \
  -F "quality=85"

Resize to target dimensions. Returns JSON with base64 output.

Form fields

• file (required)
• width, height (required) — 1–4096
• fit — cover | contain, default cover
• background — white (optional, for letterbox fill)

curl -X POST https://getpictools.com/api/v1/resize \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "[email protected]" \
  -F "width=2000" \
  -F "height=2000" \
  -F "fit=contain" \
  -F "background=white"

Remove EXIF/metadata. Returns JSON with base64 output.

Form fields

• file (required)

curl -X POST https://getpictools.com/api/v1/strip-exif \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "[email protected]"

Add a text watermark. Returns JSON with base64 output.

Form fields

• file (required)
• text (required) — watermark text, max 120 characters
• position — bottom-right | bottom-left | top-right | top-left | center, default bottom-right
• opacity — 0.1–1, default 0.7

curl -X POST https://getpictools.com/api/v1/watermark \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "[email protected]" \
  -F "text=GetPicTools" \
  -F "position=bottom-right" \
  -F "opacity=0.7"

Response example

{
  "format": "webp",
  "width": 1200,
  "height": 800,
  "size_before": 245000,
  "size_after": 89000,
  "mime": "image/webp",
  "data_base64": "..."
}