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
Image Resize
Resizes an image with aspect-ratio control, fit modes and high-quality Lanczos resampling.
Image Crop
Crops by explicit box, aspect ratio or centred region, with bounds validated against the source dimensions.
Image Compression
Compresses to a target quality or maximum byte size, reporting the achieved size and the quality actually used.
Canvas & Background
Places an image on a larger canvas with a solid or transparent background, chosen gravity and padding.