SDKs & Integrations

Integrate image compression into your workflow. Choose your platform.

Python

Python SDK v1.3.0

One-line image compression. Batch processing. Async support coming soon.

pip install deflato

Node.js

Node.js SDK v1.2.0

Native fetch, zero dependencies. Works with Node 16+.

npm install deflato

AI

MCP Server v1.4.0

Compress images from Claude, Cursor, Windsurf. First image compressor with MCP. Published on npm.

npx mcp-server-deflato

REST

REST API

Simple HTTP API. Send file, get compressed. Works with any language.

POST /api/v1/compress

Shopify

Shopify App

Compress product images, AI alt-text, bulk optimize, auto-compress, backup & restore.

Install App → WordPress

WordPress Plugin

Auto-compress, bulk optimize, WebP generation, lazy loading, Smart PNG→JPEG, WP-CLI. 43 KB.

Download ZIP →

Python Python SDK

Install and compress images in 3 lines of code.

pip install deflato

from deflato import Deflato # Initialize client = Deflato("your-api-key") # Compress a single image result = client.compress("photo.jpg", format="WEBP", quality=75) print(f"Saved {result.savings_percent}% → {result.output_path}") # Get info without saving info = client.info("photo.jpg", format="AVIF") print(f"{info.input_size:,} → {info.output_size:,} bytes") # AI Image Generation result = client.generate("sunset over mountains", model="photo", # fast | photo | design | icon format="jpg" ) print(result.output_path) # Batch compress entire folder import glob files = glob.glob("./images/*.jpg") results = client.compress_batch(files, output_dir="./compressed", format="WEBP") for r in results: print(f" {r.output_path}: -{r.savings_percent}%")

Methods:

compress(path, output, quality, max_dimension, format, strip_exif) → CompressResult
info(path, quality, format) → CompressResult (sizes, dimensions, savings)
compress_batch(paths, output_dir, quality, format) → list[CompressResult]
compress_document(path, output, quality, max_dimension) → CompressResult
convert_format(path, output_format, output) → CompressResult
generate(prompt, output, model, aspect_ratio, style, resolution, format) → GenerateResult
describe(input_path, image_url) → DescribeResult (free)
edit(prompt, input_path, image_url, output, model, format) → EditResult NEW

Node.js Node.js SDK

Zero dependencies. Uses native fetch (Node 18+) or form-data for older versions.

npm install deflato

AI MCP Server — For AI Assistants

The first image compressor with MCP support. Compress and generate images from Claude, Cursor, Windsurf, or any MCP-compatible AI assistant.

Setup for Claude Code

One command. No downloads. No dependencies.

claude mcp add deflato npx mcp-server-deflato -e DEFLATO_API_KEY=your-key

Setup for Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{ "mcpServers": { "deflato": { "command": "npx", "args": ["mcp-server-deflato"], "env": { "DEFLATO_API_KEY": "your-api-key" } } } }

Setup for Cursor / Windsurf

# Install globally npm install -g mcp-server-deflato # Run DEFLATO_API_KEY=your-key mcp-server-deflato

What you can ask your AI

"Compress all PNG files in the ./images folder to WEBP"

"Reduce photo.jpg to under 500KB"

"Convert all screenshots to AVIF with quality 60"

"What would the file size be if I compressed banner.jpg?"

"Edit portrait.jpg — add sunglasses and change background to a beach"

Available Tools

compress_image — Compress a file. Params: file_path, output_path, quality, max_dimension, output_format
image_info — Get compression stats without saving
compress_folder — Compress all images in a folder
compress_document — Compress images inside PDF, DOCX, PPTX, XLSX
convert_format — Convert image format (HEIC→JPEG, PNG→WEBP, etc.)
generate_image — Generate image from text prompt using AI (4 models, 15+ styles)
describe_image — AI alt-text / caption for any image (free)
edit_image — Edit an image with AI instructions (add sunglasses, change background, etc.) NEW

Requirements

Node.js 18+ (for npx). No other dependencies — everything is included.

npm: npmjs.com/package/mcp-server-deflato

REST REST API

Works with any programming language. Full documentation: API Docs

curl -X POST https://deflato.com/api/v1/compress \ -H "Authorization: Bearer YOUR_API_KEY" \ -F "file=@photo.jpg" \ -F "quality=75" \ -F "output_format=WEBP" \ --output compressed.webp

Endpoints:

POST /api/v1/compress — Compress image, returns binary file
POST /api/v1/info — Compression info, returns JSON
POST /api/v1/compress-document — Compress images inside PDF/DOCX/PPTX/XLSX
POST /api/v1/generate — AI image generation (4 models)
POST /api/v1/describe — AI alt-text for images (free)
POST /api/v1/edit — AI image editing (img2img) NEW
POST /api/v1/key — Generate API key
GET /api/v1/keys — List your API keys

Get Your API Key

Sign up at deflato.com
Activate Pro — use promo code or subscribe
Go to Account → Generate API Key
Copy the key and use it in your SDK/MCP/API calls

Pro plan includes 500 API requests/day. All SDKs and MCP are included.