Imagex.aratech.co is an image cache & resize proxy. Our servers resize your image, cache it worldwide, and display it.
- We don't support animated images (yet).
- We do support GIF, JPEG, PNG, BMP, XBM, WebP and other filetypes!
- We do support transparent images.
- We do support IPv6, serving dual stack.
- We do support SSL, you can use https://imagex.aratech.co/.
This can be very useful for embedding HTTP images on HTTPS websites. HTTPS origin hosts can be used by hostname with SSL.
We're part of the CloudFlare community. Images are being cached and delivered straight from 80+ global datacenters. This ensures the fastest load times and best performance. On average, we resize 1 million (106) images per hour, which generates around 25TB of outbound traffic per month.
Requesting an image:
?url=(URL encoded) link to your image, without http://
Deprecated
In January 2016 we introduced Version 2 of the imagex.aratech.co API. To make room for new improvements some parameters will be changed in the future.
We also kept Version 1 (which is in place since December 2010) of the API in place so as not to break anyone's apps. Please update your code to use the changed API parameters.
Deprecated URL-parameter values
| GET | Value | Use instead | |
|---|---|---|---|
a |
=t |
=top |
info |
a |
=b |
=bottom |
info |
a |
=l |
=left |
info |
a |
=r |
=right |
info |
Deprecated URL-parameters
| GET | Use instead | |
|---|---|---|
circle |
shape=circle |
info |
Quick reference
| Name | GET | Description | |
|---|---|---|---|
| Width | w |
Sets the width of the image, in pixels. | info |
| Height | h |
Sets the height of the image, in pixels. | info |
| Transformation | t |
Sets how the image is fitted to its target dimensions. | info |
| Crop | crop |
Crops the image to specific dimensions. | info |
| Crop alignment | a |
Sets how the crop is aligned. | info |
| Shape | shape |
Crops the image to a specific shape. | info |
| Quality | q |
Defines the quality of the image. | info |
| Output | output |
Encodes the image to a specific format. | info |
| Interlace / progressive | il |
Adds interlacing to GIF and PNG. JPEG's become progressive. | info |
| Base64 (data URL) | encoding |
Encodes the image to be used directly in the src= of the <img>-tag. | info |
Size
Width &w=
Sets the width of the image, in pixels.
<img src="//imagex.aratech.co/?url=rbx.weserv.nl/lichtenstein.jpg&w=300">
Height &h=
Sets the height of the image, in pixels.
<img src="//imagex.aratech.co/?url=rbx.weserv.nl/lichtenstein.jpg&h=300">
Transformation &t=
Sets how the image is fitted to its target dimensions. Below are a couple of examples.
Fit &t=fit
Default. Resizes the image to fit within the width and height boundaries without cropping, distorting or altering the aspect ratio. Will not oversample the image if the requested size is larger than that of the original.
<img src="//imagex.aratech.co/?url=rbx.weserv.nl/lichtenstein.jpg&w=300&h=300&t=fit">
Fitup &t=fitup
Resizes the image to fit within the width and height boundaries without cropping, distorting or altering the aspect ratio. Will increase the size of the image if it is smaller than the output size.
<img src="//imagex.aratech.co/?url=rbx.weserv.nl/lichtenstein.jpg&w=300&h=300&t=fitup">Square &t=square
Resizes the image to fill the width and height boundaries and crops any excess image data. The resulting image will match the width and height constraints without distorting the image. Will increase the size of the image if it is smaller than the output size.
<img src="//imagex.aratech.co/?url=rbx.weserv.nl/lichtenstein.jpg&w=300&h=300&t=square">
Squaredown &t=squaredown
Resizes the image to fill the width and height boundaries and crops any excess image data. The resulting image will match the width and height constraints without distorting the image. Will not oversample the image if the requested size is larger than that of the original.
<img src="//imagex.aratech.co/?url=rbx.weserv.nl/lichtenstein.jpg&w=300&h=300&t=squaredown">Absolute &t=absolute
Stretches the image to fit the constraining dimensions exactly. The resulting image will fill the dimensions, and will not maintain the aspect ratio of the input image.
<img src="//imagex.aratech.co/?url=rbx.weserv.nl/lichtenstein.jpg&w=300&h=300&t=absolute">
Crop position &a=
You can also set where the image is cropped by adding a crop position. Only works when t=square. Accepts top, left, center, right or bottom. Default is center. For more information, please see the suggestion on our UserVoice forum: #2570350 - Aligning.
<img src="//imagex.aratech.co/?url=rbx.weserv.nl/lichtenstein.jpg&w=300&h=300&t=square&a=top">
Manual crop &crop=
Crops the image to specific dimensions prior to any other resize operations. Required format: width,height,x,y.
<img src="//imagex.aratech.co/?url=rbx.weserv.nl/lichtenstein.jpg&crop=300,300,680,500">
Shape
Shape &shape=
Crops the image to a specific shape. Currently only supporting &shape=circle. More info: #3910149 - Add circle effect to photos.
<img src="//imagex.aratech.co/?url=rbx.weserv.nl/lichtenstein.jpg&w=300&h=300&t=square&shape=circle">
Trim &trim=
Trim away blank image space on edges. Use values between 0 and 255 to define a tolerance level to trim away similar color values. You also can specify just &trim, which defaults to a tolerance level of 10.
More info: #3083264 - Able to remove black/white whitespace
<img src="//imagex.aratech.co/?url=ssl:upload.wikimedia.org/wikipedia/commons/4/47/PNG_transparency_demonstration_1.png&w=300&trim">
Encoding
Quality &q=
Defines the quality of the image. Use values between 0 and 100. Defaults to 85. Only relevant if the format is set to jpg.
<img src="//imagex.aratech.co/?url=rbx.weserv.nl/lichtenstein.jpg&w=300&q=20">
Output &output=
Encodes the image to a specific format. Accepts jpg, png or gif. If none is given, it will honor the origin image format.
More info: #5097964 - Format conversion.
<img src="//imagex.aratech.co/?url=rbx.weserv.nl/lichtenstein.jpg&w=300&output=gif">
Interlace / progressive &il
Adds interlacing to GIF and PNG. JPEG's become progressive.
More info: #3998911 - Add parameter to use progressive JPEGs.
<img src="//imagex.aratech.co/?url=rbx.weserv.nl/lichtenstein.jpg&w=300&il">
Base64 (data URL) &encoding=base64
Encodes the image to be used directly in the src= of the <img>-tag. Use this link to see the output result.
More info: #4522336 - Return image base64 encoded.
//imagex.aratech.co/?url=rbx.weserv.nl/lichtenstein.jpg&crop=100,100,680,500&encoding=base64