Image Format Conversion

Converts between PNG, JPEG, WebP, AVIF, TIFF, BMP and GIF, handling alpha and colour-profile conversion explicitly.

POST /v1/image/format-convert $0.01 per call

Specification

Endpoint
POST /v1/image/format-convert
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/format-convert" \
  -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_format": "PNG",
  "target_format": "WEBP",
  "source_mode": "RGB",
  "had_alpha": false,
  "alpha_flattened": false,
  "background_used": null,
  "dimensions": {
    "width": 64,
    "height": 64
  },
  "source_size_bytes": 173,
  "output_size_bytes": 190,
  "size_change_percent": 9.83,
  "output_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