Documentation

Quickstart

ImgParcel has two surfaces: an upload API at upload.imgparcel.shop/v1 and a delivery URL that applies transforms via query parameters.

Upload

Multipart upload returns a stable asset ID. Large files use resumable chunked uploads automatically in the SDKs.

POST /v1/assets
Authorization: Bearer key_live_…

→ {"id":"ap_7Fq2","w":4000,"h":3000,"bytes":2384112}

Transform & deliver

Compose parameters on the delivery URL. Results are generated once and cached at the edge.

https://upload.imgparcel.shop/ap_7Fq2?w=800&h=800&fit=cover&fmt=avif&q=72

Supported: w, h, fit, fmt, q, blur, dpr.

Signed URLs

For private assets, sign delivery URLs with an expiry. Requests without a valid signature are rejected.

Resumable uploads post chunks to /v1/assets/chunks; the SDK handles ordering, retries and finalization for you.

SDKs

Drop-in clients for Node, Python, PHP and Ruby. npm i @imgparcel/js