Choose the part you want to keep
x and y position the crop; width and height describe the selected region. Inspect the source dimensions before choosing coordinates.
Try a crop in the browser →API Documentation
Crop Image API Documentation
Treat the crop as a pixel rectangle.
The example uses x = 30, y = 30, width = 90 and height = 60 pixels. The region ends at x = 120 and y = 90; the URL is a separate query value.
Keep the legacy request explicit
This reference documents the endpoint shown below. Check the newer API reference when starting a v2 integration.
Open v2 processing documentation →This uses encodeURIComponent for one query-parameter value. The browser does not fetch the URL. Keep the API version and parameter names from the request below.
For new subscribers joining Pixelixe after March 21th 2021, access the more recent V2 documentation here. For older subscribers, don't worry, this V1 documentation will remain supported and active indefinitely. Get more detail regarding the new V2 release and upgrade prerequisites here.
Manipulate and transform images and photos in real time with our easy to use APIs.
Introduction :
Crop your photos and images by defining four coordinates: the new height and width pixels and the x and y positions. JPG, PNG, BMP, TIFF or GIF
Example : Crop images to 90×60 starting at 30×30 from the top left
https://studio.pixelixe.com/api/crop/v1?apiKey=YOUR_API_KEY&width=90&height=60&x=30&y=30&imageUrl=https://yoururl.com/image.png
Original image :
The API parameters
GET https://studio.pixelixe.com/crop/resize/v1
| Parameter | Type | # | Description |
|---|---|---|---|
| apiKey | string |
Required |
The API Key is the only way to authenticate your application with Pixelixe API. A unique API key is provided after you signup to our API plan. Ex : ppvkwgDgNRbMbYlCgaM3UyDFPP12 |
| width | integer |
Required |
Use the width and height parameters (pixel) to choose the new expected dimension of your image. Use "auto" if you want to keep ratio when resizing the width of your image |
| height | integer |
Required |
Use the height parameter to set the height of the cropped region in pixels. |
| x | integer |
Required |
Coordinate from the top corner of the image (x co-ordinate of cropping -> pixel). |
| y | integer |
Required |
Coordinate from the left corner of the image (y co-ordinate of cropping -> pixel). |
| imageUrl | string |
Required |
Set the url of the image you want to crop. (Supported type : jpeg, png, bmp, tiff and gif) Advice: Use encodeURIComponent when passing the imageUrl as an API parameter. Ex : https://yourwebsite/yourimage.png will become https%3A%2F%2Fyourwebsite%2Fyourimage.png |
| imageType | string |
Optional |
Set the image type expected as output of the API between, png, jpeg or bmp. (png by default). |
The API output
The API will directly return the cropped image buffer.
You want to transform your photos without API...?
Resize, Flip, Filter, add text, icons, and much more
We created a free online graphic creation tool and image editor to let anyone with no design experience (No account required) :
- Flip, Rotate, Resize, Crop and transform images
- Add Instagram like filters
- Add rich text (From thousands of fonts)
- Add icons, photos and graphics (From 2.000.000 free photographer's images)
