Image Operations - Introduction

Image Operations / Introduction

On this page:

The Optidash Image API offers blazingly-fast image transformations resulting in unparalleled image quality. We use our proprietary, GPU-optimized rendering pipeline running entirely on the Apple® platform. You can resize, crop, add watermarks and masks to your images and even enhance them automatically with intelligent filters.

By default, all resulting images are treated with our Smart Image Optimization algorithms to ensure they are immediately ready for publishing.

Quick Example

Say you'd like to process an image with the Image Upload method (upload an image for processing) and crop-out a portion of the image with a face and give it a nice padding, resize that fragment to a smaller size, automatically enhace the image to give it a more vibrant look and finally apply an elliptical mask on a transparent background using highly optmized PNG as the output format. With Optidash Image API you can stack together as many operations and filters as you like.

An example JSON request will look like the following:

{
    "crop": {
        "mode": "face",
        "padding": 50
    },
    "resize": {
        "mode": "auto",
        "width": 150,
        "height": 150
    },
    "auto": {
        "enhance": true
    },
    "mask": {
        "shape": "ellipse"
    },
    "output": {
        "format": "png"
    },
    "optimize": {
        "compression": "high"
    }
}
Given the input image 750px × 400px
Crop out the face with 50px padding, resize to 150px × 150px, automatically enhance and apply an elliptical mask

An example cURL request incorporating Image Upload method and said transformations would look like so:

curl https://api.optidash.ai/1.0/upload -u your-api-key: \
-F file=@/path/to/image/file.jpg \
-F data='{
    "crop": {
        "mode": "face",
        "padding": 50
    },
    "resize": {
        "mode": "auto",
        "width": 150,
        "height": 150
    },
    "auto": {
        "enhance": true
    },
    "mask": {
        "shape": "ellipse"
    },
    "output": {
        "format": "png"
    },
    "optimize": {
        "compression": "high"
    }
}'
Grace Przemek Magda Damian
Have questions? Let's talk!We usually respond in just under an hour

Thanks for reaching out!

We've received your message
and will get to it as quickly as possible.

Whoops, looks like something went wrong.

We encountered an unexpected error and cannot complete your request. Please try reloading the page.