AVOD Image Proxy

An Akamai Image Manager backed proxy for AVOD.

Client

Image optimization and transformation. Derivative image widths (pixels): 80, 130, 180, 250, 350, 450, 550, 640, 750, 828, 1080, 1200, 1350, 1500, 1650, 1800, 1920, 2048, 2200, 2400, 2600, 2800, 3024, 3840, 4200, 4600, 5000.

If we detect a device with higher pixel density (> 1 typically), we will multiply the width and search for the breakpoint. For instance, if the “width” parameter is set to “300”, but the pixel density is 2, we will pick 640 as the breakpoint for delivering the derivative image.

Deprecated, disallowed parameters: resize, retina, shape, gravity, quality, mask.
GET /

width=300 (returns width 320)

width=320 (returns width 320)

width=340 (returns width 640)

width=640&blur=20

width=640&dark=70

  • Parameters
  • Name Description Required Type Example
    source

    Encoded URL of the image to convert. Must be whitelisted in the Akamai property.

    		 yes string https%3A%2F%2Fimg.tv4.incomet.io%2F06a90ce1-6b6d-40f6-ae9d-e261bc5881d0%2Fcrop16x9.jpg
    width

    The requested width of the image. This will return an derivative image that is never smaller than the provided width. Max limit for width 5000.

    		 no integer 300
    blur

    How much the image should be blurred. Valid values are 0-50.

    		 no integer 25
    dark

    How much darkness to overlay. Valid values are 0-99.

    		 no integer 20

Info

Akamai Image Manager backed custom API. This AVOD variant of the API is not entirely backwards compatible, and using deprecated parameters will result in a HTTP 400 error. Only AVOD hosts are whitelisted, and the Composed Images service is no longer supported as an origin. The purpose of a decoupled implementation is to provide portability. The implementation transforms the incoming URL parameters to an imquery that is passed on to the default IM policy. All configuration is made in a single property and policy. New imqueries can be added and mapped to custom parameters as needed.

Breakpoint widths are customizable. If the requested width is not available, a larger derivative is returned. If the requested image differs a lot in size, a new breakpoint width is needed. See select derivative and mobile widths for more information. Akamai specific parameters must be mapped to custom Image Proxy parameters.