Image Tools API
FreemiumResize, crop, convert, rotate and compress images, add text watermarks, extract colour palettes and make placeholder images.
Documentation
Resize, crop, convert, rotate and compress images, add text watermarks, extract colour palettes and make placeholder images.
What you get
- Resize & convert — JPEG, PNG, WebP, GIF, BMP, TIFF, with quality control
- Watermark images with text
- Image info — dimensions, format, colour mode, EXIF
- Colour palette extraction
- Placeholder images of any size
Great for e-commerce catalogues, CMS uploads, thumbnails, social media tools and mock-ups.
Quick start
Subscribe to a plan (the Basic plan is free), then call the API at https://image-tools.p.apihiver.com with your key in the X-API-Key header:
curl "https://image-tools.p.apihiver.com/v1/placeholder?width=300&height=200" \
-H "X-API-Key: YOUR_API_KEY" -o outputEndpoints
| Method | Path | What it does |
|---|---|---|
POST | /v1/transform | Resize / fit / convert / compress / rotate an image |
POST | /v1/info | Image format, size, colour mode and EXIF basics |
POST | /v1/watermark | Add a text watermark (position, opacity, size, colour) |
POST | /v1/colors | Dominant colour palette of an image (hex, RGB, share) |
GET | /v1/placeholder | Generate a placeholder image of any size with a label |
Open the Endpoints tab to see every parameter, example request and example response, and to try the API live.
Sending a file
Endpoints that take an image accept any of:
- multipart/form-data with the image in the
filefield, plus options as form fields - JSON
{"url": "https://…"}pointing at a public image (private/internal addresses are refused) - JSON
{"base64": "…"}(adata:URL prefix is fine)
Max size: 25 MB. Files are processed in memory and never stored.
Errors
Every error is JSON with the same shape:
{"error": {"code": "INVALID_INPUT", "message": "Provide a file upload, 'url', or 'base64'."}}| HTTP | Code | Meaning |
|---|---|---|
| 400 | INVALID_INPUT | A parameter is missing or has the wrong format — the message says which |
| 401 | UNAUTHORIZED | Missing or invalid X-API-Key |
| 413 | TOO_LARGE | The file is over the size limit |
| 429 | — | Plan quota or rate limit reached (see the X-RateLimit-* headers) |
| 502 / 503 / 504 | — | A data source or the API server is temporarily unavailable — retry after a few seconds |
Data & privacy
Data comes from Pillow, processed on our servers. Images are not stored.
Image Tools API FAQ
- Is the Image Tools API free?
- Yes. The Basic plan is free and includes 50 requests per month — no card needed. Paid plans start at ₹499 per month for 2,000 requests.
- How much does the Image Tools API cost?
- Basic: free for 50 requests; Pro: ₹499/month for 2,000 requests; Ultra: ₹1,999/month for 10,000 requests; Mega: ₹4,999/month for 30,000 requests. Billing is monthly and you can cancel any time.
- How do I use the Image Tools API?
- Subscribe to a plan on APIHiver, create an API key in the Console, then send requests to https://image-tools.p.apihiver.com with your key in the X-API-Key header. You can also try every endpoint in the browser playground first.
- What endpoints does the Image Tools API have?
- It has 5 endpoints: Resize / fit / convert / compress / rotate an image (POST /v1/transform); Image format, size, colour mode and EXIF basics (POST /v1/info); Add a text watermark (position, opacity, size, colour) (POST /v1/watermark); Dominant colour palette of an image (hex, RGB, share) (POST /v1/colors); Generate a placeholder image of any size with a label (GET /v1/placeholder).
- What are the Image Tools API rate limits?
- Basic: 1 request per second; Pro: 2 requests per second; Ultra: 4 requests per second; Mega: 8 requests per second. Monthly quotas depend on the plan; every response includes X-RateLimit headers showing what's left.
- Can I use one API key for the Image Tools API and other APIs?
- Yes. One APIHiver key works for every API you subscribe to, so you don't need a separate account or key per provider.
Related APIs
Background Remover API
ImageBy APIHiver · Updated 2w ago · ★ 5.0 (1)
Remove image backgrounds in one call — transparent PNG/WebP cut-outs or a solid-colour background, from a file, URL or base64.
QR Code Generator & Reader API
OthersBy APIHiver · Updated 1w ago
Create QR codes for links, text, UPI payments, Wi-Fi logins and contact cards (PNG/SVG, custom colours) and read QR codes from images.
Video Tools API
VideoBy APIHiver · Updated 1w ago
Get video info, grab thumbnails, make storyboard contact sheets, extract audio (MP3/WAV/M4A) and convert clips to GIF.
OCR API — Image to Text
OCRBy APIHiver · Updated 1w ago
Extract text from images and scans in English, Hindi and Marathi, and pull out emails, phone numbers, URLs, PAN and GSTIN.
Barcode Generator & Reader API
OthersBy APIHiver · Updated 1w ago
Generate EAN-13, UPC, Code 128, ISBN and other barcodes as PNG or SVG, read barcodes from images, and validate check digits.
Endpoints
5 endpoints — full list is in the sidebar on larger screens.