---

name: crop-image description: "Crop Image. Crop images by percentage-based coordinates. Triggers: crop image, trim image, resize image, cut image" allowed-tools: Bash(curl *), WebFetch

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

Documentation

• each::labs Docs
• API Reference