Image Toolkit
## Overview The Image Toolkit API provides 25 endpoints for image metadata extraction, format conversion, resizing, and analysis — all without storing your images. ## Key Features - **Metadata Extraction**: EXIF data, dimensions, color space, DPI, ICC profile - **Format Conversion**: PNG, JPEG, WebP, GIF, BMP — bidirectional conversion - **Resizing**: Proportional scaling, cropping, thumbnail…
Image Toolkit endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET |
Pattern SVG placeholder /placeholder/pattern |
Generate an SVG placeholder with a repeating background pattern. Supported patterns: checkerboard, stripes, dots. |
| POST |
Detect image format /detect/format |
Detect the image format from base64-encoded binary data using magic byte signatures. Supports JPEG, PNG, GIF, BMP, WebP, TIFF, ICO, AVIF, HEIC, HEIF, SVG. No image libraries are… |
| POST |
Validate image data /detect/validate |
Check whether base64-encoded data represents a valid, recognised image. Returns the detected format if valid. |
| GET |
Get MIME type for a format /detect/mime |
Look up the MIME type for a given image format name. Accepts common aliases (jpg, jpeg, tif, tiff, gif, etc.). |
| GET |
List all supported formats /detect/formats |
Returns metadata for all image formats supported by this API. |
| POST |
Parse image dimensions /dimensions/parse |
Extract width and height from base64-encoded image data by reading format-specific binary headers — without decoding the full image. Supports PNG (IHDR), JPEG (SOF), GIF… |
| GET |
Get social media image dimensions /dimensions/social |
Return the optimal image dimensions for a specific social media platform and image type. Use GET /social/platforms for a full list of platforms and types. |
| GET |
Solid color SVG placeholder /placeholder/svg |
Generate a solid-color SVG placeholder image with optional centered text. Returns SVG XML (Content-Type: image/svg+xml). |
| GET |
Get all dimensions for a platform /social/dimensions |
Return every image type and its dimensions for the specified social media platform. |
| GET |
Gradient SVG placeholder /placeholder/gradient |
Generate an SVG placeholder with a linear gradient background. Supports horizontal, vertical, and diagonal directions. |
| GET |
Large text SVG placeholder /placeholder/text |
Generate an SVG with large, centered text — ideal for wireframe mockups. The text fills most of the available space. |
| GET |
List all platforms /social/platforms |
Return all supported social media platforms and the image types available for each. |
| GET |
Get optimal dimensions with tips /social/optimal |
Return the optimal image dimensions and platform-specific tips for a given platform + image type combination. |
| POST |
WCAG contrast checker /color/contrast |
Calculate the WCAG 2.1 contrast ratio between two hex colors and return AA/AAA pass/fail grades for normal and large text. Contrast ratio ranges from 1:1 (no contrast) to 21:1… |
| POST |
Generate color palette /color/palette |
Accept a list of hex colors and generate a harmonious palette based on the requested scheme. Schemes: complementary, analogous, triadic, split-complement, tetradic,… |
| GET |
Color space info /color/spaces |
Return detailed information about common image color spaces: RGB, CMYK, HSL, HSV, LAB, XYZ, sRGB, and P3. |
| GET |
Health check /health |
Returns service health status and timestamp. Suitable for uptime monitoring. |
| GET |
Analyze a hex color /color/analyze |
Return comprehensive color information for a single hex color: RGB, HSL, HSV, CMYK, luminance. |
| POST |
Encode to Base64 /convert/to-base64 |
Encode image bytes to Base64 with optional data URI prefix. If the input is already valid Base64, it is returned as-is. Supply a format name to get a proper data URI prefix. |
| POST |
Decode Base64 image data /convert/from-base64 |
Decode base64-encoded image data and return metadata: byte size, detected format, MIME type, and data URI prefix template. The raw bytes are not returned — only analysis results. |
| GET |
Generate data URI /convert/data-uri |
Construct a complete data URI string from a format name and base64 data string. Format: 'data:{mime};base64,{data}' |
| GET |
Estimate file size /convert/filesize |
Estimate the compressed file size for an image with given dimensions and format. Uses typical compression ratios for each format. Results are estimates only — actual size depends… |
| GET |
Calculate aspect ratio /convert/aspect-ratio |
Calculate and simplify the aspect ratio from width and height. Returns the simplified ratio string (e.g. '16:9'), decimal ratio, orientation, and common name if applicable. |
| GET |
Calculate resize dimensions /convert/resize |
Calculate the new width and height when resizing an image while maintaining the original aspect ratio. Provide either target_width or target_height (not both). |
| GET |
API root / |
Returns API name, version, and available route groups. |
Image Toolkit pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| Pro | $9.99 / month | 20 / minute |
|
| Ultra | $29.99 / month | 100 / minute |
|