APIs › Image, SVG, QR & Barcode › Image Crop

Image Crop

Crops by explicit box, aspect ratio or centred region, with bounds validated against the source dimensions.

POST /v1/image/crop $0.01 per call

Specification

Endpoint

POST /v1/image/crop

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/crop" \
  -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.

{
  "original": {
    "width": 64,
    "height": 64,
    "mode": "RGB",
    "format": "PNG",
    "has_alpha": false,
    "megapixels": 0.004
  },
  "crop_box": {
    "left": 0,
    "top": 14,
    "width": 64,
    "height": 36
  },
  "cropped": {
    "width": 64,
    "height": 36
  },
  "mode": "aspect",
  "area_kept_percent": 56.25,
  "output_size_bytes": 152,
  "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