APIs › Image, SVG, QR & Barcode › Thumbnail Generator

Thumbnail Generator

Generates thumbnails at several sizes in one call, with smart-crop or fit mode and consistent output encoding.

POST /v1/image/thumbnail $0.01 per call

Specification

Endpoint

POST /v1/image/thumbnail

Price

$0.01 per call · tier standard_data

Payment

x402 on X Layer (chain 196) · settled in USDG or USDT0 · scheme exact

Data source

Local sandboxed processing of the uploaded image

Timeout

60 seconds

Max request

20 MB

Version

1.0.0

Calling it

The first call returns a 402 with the payment challenge. Retry with a signed authorisation in the X-PAYMENT header — see the payment guide for the exact shape.

curl -i -X POST "https://api.dana-edu.pp.ua/v1/image/thumbnail" \
  -H "content-type: application/json" \
  -d '{ ... }'

Response

Real output, captured by running this endpoint at build time — not written by hand. Volatile fields such as timestamps are elided. Captured 2026-07-30.

{
  "source": {
    "width": 64,
    "height": 64,
    "mode": "RGB",
    "format": "PNG",
    "has_alpha": false,
    "megapixels": 0.004
  },
  "mode": "fit",
  "output_format": "WEBP",
  "quality": 82,
  "thumbnail_count": 2,
  "total_bytes": 344,
  "thumbnails": [
    {
      "requested_size": 150,
      "width": 64,
      "height": 64,
      "size_bytes": 172,
      "filename": "<varies per call>",
      "content_base64": "<base64 payload elided from the published example>"
    },
    {
      "requested_size": 300,
      "width": 64,
      "height": 64,
      "size_bytes": 172,
      "filename": "<varies per call>",
      "content_base64": "<base64 payload elided from the published example>"
    }
  ]
}

Every response is wrapped in the same envelope: data plus warnings, sources, confidence, informational_only and a measured processing_ms. See the envelope reference.

Related endpoints