awesome-genmedia Crop Image
Crop images using percentage-based coordinates and dimensions. Specify the crop region as percentages of the original image width and height for easy, resolution-independent cropping.
Quick Start
Requires an each::labs API key. Get one at eachlabs.ai.
curl -X POST https://api.eachlabs.ai/v1/prediction \
-H "Content-Type: application/json" \
-H "X-API-Key: $EACHLABS_API_KEY" \
-d '{
"model": "crop-image",
"version": "0.0.1",
"input": {
"image_url": "https://example.com/photo.jpg",
"x_percent": 25,
"y_percent": 16,
"width_percent": 50,
"height_percent": 50,
"output_format": "png"
}
}'
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| height_percent | number | 100 | Height as percentage of image height (0-100). |
| image_url | string | - | The URL of the image to crop. Max file size: 9.5MB. |
| output_format | string | png | Output format for the cropped image. Options: png, jpg, jpeg, webp |
| width_percent | number | 100 | Width as percentage of image width (0-100). |
| x_percent | number | 25 | X coordinate as percentage of image width (0-100). |
| y_percent | number | 16 | Y coordinate as percentage of image height (0-100). |
Examples
Center crop to 50%:
curl -X POST https://api.eachlabs.ai/v1/prediction \
-H "Content-Type: application/json" \
-H "X-API-Key: $EACHLABS_API_KEY" \
-d '{
"model": "crop-image",
"version": "0.0.1",
"input": {
"image_url": "https://example.com/landscape.jpg",
"x_percent": 25,
"y_percent": 25,
"width_percent": 50,
"height_percent": 50
}
}'
Crop top-left quadrant:
curl -X POST https://api.eachlabs.ai/v1/prediction \
-H "Content-Type: application/json" \
-H "X-API-Key: $EACHLABS_API_KEY" \
-d '{
"model": "crop-image",
"version": "0.0.1",
"input": {
"image_url": "https://example.com/group-photo.jpg",
"x_percent": 0,
"y_percent": 0,
"width_percent": 50,
"height_percent": 50,
"output_format": "jpeg"
}
}'
Related Models
- Rembg - Remove image backgrounds
- Each Upscaler - Upscale image resolution