Optimize / Transform

Optimize / Transform file endpoint accepts multiple content-type;

  • "multipart/form-data" (for binary form-data file uploads, URL, base64)

  • "application/x-www-form-urlencoded" (URL, base64) (our usual request type)

  • "application/json" (URL,base64) (our usual request type)

Optimize / Transform your local files or from URL

POST https://api.imagemash.io/v1/optimize

Headers

Name
Type
Description

apikey*

String

Your API Key

Request Body

Name
Type
Description

image*

Multiple

Accepts 3 type;

binary: As form-data (buffer), base64: As base64 string, URL: URL of a file. Eg. https://examle.com/logo.png

outputType

String

Return type of your optimized image. Choose which one suits your use-case.

link: A temporary URL contains image data.

base64: A base64 string represantation of image.

buffer: Binary represantation of image.

Default: link

transforms

Object

An object contains transform objects. See

Transform Options

for available transform options. See

An example transforms object

{
    "image": "http://storage.imagemash.io/temp/HEbJT0/Asset 1.webp",
    "info": {
        "outputFormat": "webp",
        "outputType": "link",
        "originalName": "Asset 1",
        "originalSize": 5053154,
        "originalSizeHuman": "4.82 MB",
        "size": 920454,
        "sizeHuman": "898.88 KB",
        "savedPercent": 81,
        "savedBytes": 4132700,
        "savedBytesHuman": "3.94 MB",
        "thumbnail": "UklGRrACAABXRUJQVlA4IKQCAADwDQCdASojACMAPm0skkYkIqGhLjgLMIANiWIArDO8w4mrn8vQ1tgOei0zfovfVn/31AR5HwSWnG/OsB9AvoniL/KeID6V+Zz/pOMGMf513p/2AujN5ABRbYyqlPnVZl8OPPfUxEz2TWdncvuWFIMm3Nnqm6i+dAAA/v72Ff/EVjX54pve16nYydbdwQY4A2qTNiTtWsOg3HvtWRCVB/6LeYnp/fctm1Mj8jMhl0xLK/O+M4rgbpt5P1KZf3wECrp4ktra25SBMOH/Q1Hsh0mpUFpNU3J8ebnRlHg9iS9oD3fP6jgcBORfCIAYW5vK0PtHi42csbq7CJS+ImwZgFad5hAZVJIESdoNGUX0ofOogRQhw9K6efVuwd7KevZ8fUPPBMp0SX8utgQf95Ov/sfN8qbpL3FzuvE7ZPspvyyAe2qm1vefQr1nJbnUGH9+0OzVkbrV+2blNAXw7ZrIe2EyUAvBIOFY7wKR5m0RBL452KVkDaURmkadJSuGT3DbbJzsxPjaM0ZfIqwUlfgCE2zpzoqOzGivN2KitC7iWTXD9YW48zY6Tdc51BIqoLpfhyBN8HTejXDdnb3IPRClYGrgeTEZjfwvXnFU6rGs83/hjaN+3TSnFuGubuMfoWnJ1RvpNs40OzeYgOhDrgKwbH/6Aj53ppudC5RvCE4IRzdVffJY74XnwY3wLfO9/mqns5Kfjr7ufpKa4/kjAbhlUDfZNW/L+DALag9zGYX5zV0PVfudBh2hMZApHaDqKOVs97hh0zNY6fExe481XicW11gL1qF71hzXEJJ/Cp3LyPlOCaP8i4y9ilnT69vKc6C7aY3zHZ53Tm2mL0yaVTUoLLyhSeOQnvjHlN1QCXhl6mZIBCoth7XVlqJAEXahv3ojafwB/BAA",
        "fileLocation": "temp/HEbJT0/Asset 1.webp"
    }
}
An example transforms object
"transforms": {
  "width": 60,
  "border": {
    "color": "red",
    "width": 2
  }
}

Import Postman Collection Run in Postman

Example Codes - Binary(form-data)

curl --location 'https://api.imagemash.io/v1/optimize' \
--header 'apikey: your_api_key' \
--form 'transforms[height]="100"' \
--form 'transforms[border][width]="2"' \
--form 'transforms[border][color]="red"' \
--form 'image=@"/E:/Users/logo.png"'

Example Codes - URL/base64

curl --location 'https://api.imagemash.io/v1/optimize' \
--header 'apikey: your_api_key' \
--header 'Content-Type: application/json' \
--data '{
    "image": "UklGRtIDAABXRUJQVlA4WAoAAAAQAAAAIgAAIgAAQUxQSLwBAAABkHPbtrE99z6fbduKbdu2etuobKNNqozvN0RdUtm29RrPc/cOHkV9RDBy2zaS1N5mHzuP4D+isFcm5jd1aC5MksK1aZNO3/MpIPDw7OwsdyQue6JAs1Cvt6Y5I7vfBElARQ2AJJ4M0Zz2nG8k8ODwrB5tuk7ZdV2RCC7T7PfcMIh705Kl+TEShl8Boa+QdvQJkvqxFGFn/IYwqU+wIesOYGzQhIPzw+SrUitbAJyKdf5w60Ack2ZyPwB30oWz8edAX6WZBYCaJ7T45PTs/KKS0pKi/Oz05HhN9I8Sa6UQctD2u4C6eefxy/cfP3395vF6vn35/PH9y8d3rurks22DZHUU/D0RrW4Bf1e0/EfU/IFDauT01pcgPJ5ARDdgVemRgOcrgPet03/9kQWAWlhS3diue/8hI0aNHjViSP/u7RqrS6bqwDrzn895D9x28+MTLoG+Ktv4HI9xjs8mEMelfQhXa04sMIXQNspAdF+Smyg7FQK4OdFa3IShl0H+KoT9+gYAt/dN7dzUceL2qwZMtXIs5y2YNCI25ZQuKr7ctuJ4tTXV5aCYfOaeD24GheO4yWvq2FzgOG7430hWUDgg8AEAALAKAJ0BKiMAIwA+bTCTRyQioaEuNAgAgA2JaQATzj9V6IfzsfWV2FqCmNf8LyifSfsFfq91ZB8mMsTV/UQM8W+f9ic6licxUapod9uoKcQJltisOrb1DT+dtHQ83gAA/v0QvgXoDzqn9+k0aOd/Y7qZHXXp/AsBlriVL2PJZ08kqL+ZuzUNm/WVP9eX14a5jZSw7VxRZQNcacasKvynWVUcnd/p/TmyFdg0iv/YuQZi6pWg4lf+2W2uctmsjpcWVcQNmuybP+oZulAcwzPNhxfHf8xp3cuN112VibDTD6Lh3ahJ1tSmY01Y1UZ8eQeqSlxXIb5Lk5RZgDIYMnfRHf1hPtDQZfBB99hm1sfCzKO2wNlzLdV9lRdEEA05q4d/f1oPi6zidsR//ATPs86cq3kvkhESSYrz930Tv/49jJcQex/q7/0EknnhqQw0TQtGx1vWClsQgIUi5/ebhjcVngovAvnPm5zZZKXEBwpAgDGJPgfgQqmBd2woI+kZvTM2CcQA3trswPvdcKVVE3lLqto/s0zO+P/tDOtr/WGTneKm/cGSEvyfgNCnIuDH9DPSvXDKck13KmwFR46GI0CYdJaSopuvVRCj1yZe43uxtJhrFcpVdFMWAdIM0DLttA8jdMcrf4LSosCGjaKc36VkAAA=",
    "outputType": "link",
    "transforms":{
        "width": 60,
        "border":{
            "color":"red",
            "width": 2
        }
    }
}'

Last updated