There are some breaking changes in the API between v1 and v2 of the Image Service.
We'll outline all of these below. The best way to check whether your images still
work is to replace
v2 in your image URLs and
compare the two.
You can also compare the transformed images for v1 and v2 of the service on the comparison page.
Making the switch should be as simple as performing a replacement on all of the URLs
in your application. Image Service v2 has moved to
ft.com, the URLs
below illustrate the change that needs to be made:
The image modes
have been removed from the service. The
debug mode has been added.
The ability to produce an image from multiple sources (spriting) has been removed from the service. This means that the following endpoints are no longer supported:
In V2, some limits have been added to both transformed images and source images:
scheme query parameter is no longer supported, as multiple images
cannot be requested at once. The scheme should form part of the image URI.
imageset query parameter is no longer supported, as multiple images
cannot be requested at once.
tint query parameter has changed, with results differing from v1.
You can see the differences illustrated on the comparison page.
SVG images can still be tinted, and they no longer require a colour to be specified twice.
compression query parameter is no longer supported, use
quality alone to manipulate the level of compression that is applied
to the image.
format query parameter can now be set to
gif, and all
GIF images (including animated ones) can be resized and cropped.
format query parameter is set to
auto, it will now
use Cloudinary's automatic format detection.
This includes serving WebP or JPEG-XR images for browsers which support them.
images/metadata endpoint now doesn't include a