Image processing API

If you want to use this API, get in touch with us.

Main concepts

The server uses a temporary image store, accessible through /images. Images can be uploaded to that store, and downloaded from that store. Every image on that store has a unique ID derived from its content, and written as 64 hex digits, e.g.

0a6677d80420b2a83473f36d2625f38e675c5d7e1efaa6edb861f69cba4d9b59

Images are automatically removed by the store if they have not been used for more than 1 hour. Whenever an image is accessed, its expiration is extended.

The image store is not limited to storing images. Any file can be stored there.

Accepted image formats

The following file formats are accepted for processing images:

A number of other image formats (BMP, GIF, TIFF, WebP, ...) are accepted for conversion to one of the above formats.

API calls

GET /backend/blobs/TOKEN Retrieves (downloads) an image.
POST /backend/blobs Stores (uploads) an image and returns the token.
POST /backend/convert Converts an image to JPEG or PNG.
POST /backend/croppola Intelligently crops generic pictures (croppola algorithm).
POST /backend/soft-expand Soft-expands an image by warping the sides.
POST /croppola/... Legacy croppola requests.

Support and questions

If you have questions regarding the API or the online tools, or if things don't work as documented here, please contact Thomas Lochmatter.