Skip to content
smallPict
Start free
DocsDeveloper reference

Build with the SmallPict API.

Add image processing to your app. Compress, convert and resize millions of images through one fast endpoint.

Quickstart guide

Ready in under 2 minutes
  1. 01

    Create an account

    Sign up for a free developer account to get your initial monthly quota.

  2. 02

    Generate API key

    Visit the dashboard and create a scoped key for production or WordPress.

  3. 03

    Process an image

    Send your first POST request with an image URL or binary to receive an optimized AVIF or WebP.

HMAC-SHA256 auth

Every API request requires an HMAC-SHA256 signature calculated from the HTTP method, path, timestamp, and body hash to prevent replay attacks.

Header
X-API-Key: sp_sdk_9a8b7c6d5e4f...
X-Timestamp: 1716301234
X-Signature: HMAC-SHA256(method + path + timestamp + sha256(body))
Manage API keys in dashboard

Interactive playground

Inspect real-world request shapes and response payloads for our most common endpoints.

POST/v1/optimize

Lossless or lossy conversion to AVIF or WebP, with the format chosen per request.

  • WebP & AVIF conversion
  • EXIF metadata removal

POST/v1/convert

Direct format transcoding across PNG, JPG, WebP, and AVIF formats.

  • Preserves alpha transparency
  • ICC color profile support

POST/v1/resize

Responsive thumbnails and banners within the dimensions you set.

  • Width & Height scaling
  • Aspect ratio preservation
cURL
curl -X POST https://api.smallpict.app/v1/optimize \
  -H "X-API-Key: sp_sdk_9a8b7c6d5e4f..." \
  -H "X-Timestamp: 1716301234" \
  -H "X-Signature: 3a9f8b2c4d6e..." \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "hero.jpg",
    "mime_type": "image/jpeg",
    "filesize": 2508800,
    "options": {
      "format": "avif",
      "quality": 80,
      "max_width": 800
    }
  }'

Transform parameters

Ready to integrate?

Get your API key in seconds and start compressing images programmatically today.