# Crop Image

A utility endpoint that crops images efficiently for workflow processing, enabling precise framing and clean image preparation.

## API Information

- **Model Slug:** crop-image
- **Branded URL:** https://www.eachlabs.ai/eachlabs/eachlabs/crop-image
- **Provider:** each::labs
- **Category:** Image to Image
- **Output Type:** image
- **Status:** active
- **Version:** 0.0.1
- **Base Cost:** Execution-time pricing: $0.0002475/sec based on run_time
- **Estimated Processing Time:** 1 seconds
- **Last Updated:** 2026-07-06
- **Interactive Demo:** https://www.eachlabs.ai/ai-models/crop-image

## Pricing

- **Charge Type:** dynamic
- **Pricing Details:** Execution-time pricing: $0.0002475/sec based on run_time

### Pricing Rules

| Condition | Pricing |
| --- | --- |
| Rule 1 | Execution-time pricing: $0.0002475/sec based on run_time |

## Input Schema

| Parameter | Type | Required | Default | Constraints | Description |
|-----------|------|----------|---------|-------------|-------------|
| image_url | string | Yes | - | - | The URL of the image to crop  Max file size: 9.5MB, Timeout: 20.0s |
| x_percent | number | No | 25 | 0–100 | X coordinate as percentage of image width (0-100) |
| y_percent | number | No | 16 | 0–100 | Y coordinate as percentage of image height (0-100) |
| width_percent | number | No | 100 | 0–100 | Width as percentage of image width (0-100) |
| height_percent | number | No | 100 | 0–100 | Height as percentage of image height (0-100) |
| output_format | string | No | png | png,jpg,jpeg,webp | Output format for the cropped image |

## Example Request

```bash
curl -X POST https://api.eachlabs.ai/v1/prediction/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "crop-image",
  "input": {
    "image_url": "https://storage.googleapis.com/magicpoint/inputs/crop-image-input.png"
  }
}'
```

## Output Schema

Response returned by `GET /v1/prediction/{id}` when the job completes:

```json
{
  "status": "success",
  "predictionID": "string",
  "output": "string (URL of generated image)",
  "metrics": {
    "predict_time": "number (seconds)"
  }
}
```

## Polling

```bash
curl https://api.eachlabs.ai/v1/prediction/{PREDICTION_ID} \
  -H "Authorization: Bearer YOUR_API_KEY"
```

| Status | Meaning |
|--------|---------|
| `processing` | Still running — poll again |
| `success` | Done — read `output` |
| `error` | Failed — read `message` / `details` |

## Webhook (alternative to polling)

Pass `"webhook_url": "https://your.host/path"` in the create request. Eachlabs POSTs this payload when the job ends:

```json
{
  "exec_id": "prediction-uuid",
  "status": "succeeded",
  "output": "https://...",
  "error": ""
}
```

`status` is `"succeeded"` or `"failed"`. `exec_id` equals the `predictionID` from create. Return 2xx within 30 seconds.

## Errors

Error body: `{ "status": "error", "message": "...", "details": "..." }`

| Code | Meaning |
|------|---------|
| `400` | Invalid input |
| `401` | Missing / invalid `Authorization` bearer token |
| `404` | Unknown model or prediction id |
| `429` | Rate limit — 100 creates / min, 10 concurrent per key |
| `5xx` | Retry with backoff |

## Overview

No specific AI model named "crop-image" was found in current web search results across GitHub, Reddit, Hugging Face, or other platforms. Search results primarily reference general image cropping tools, libraries, and techniques rather than a dedicated AI model for cropping images based on percentage values. These include Flutter-based image editors using packages like image*cropper for aspect-ratio controlled cropping, CSS object-fit for responsive cropping, and various GitHub repositories for image processing in frameworks like Angular and MiniMagick.*

**The described functionality aligns with non-AI libraries such as imagecropper in Flutter, which enables cropping with presets like square or 4:** 3 ratios while preserving quality, often combined with rotation and filters. No developer or AI-specific architecture is associated with a model called "crop-image"; instead, results point to rule-based processing in app development tutorials and UI components. Unique aspects in related tools include gesture-based interactive cropping, live previews, and automatic aspect ratio handling without quality loss during rotation.

Without evidence of an AI model by this name, it appears to describe conventional image manipulation rather than generative AI technology. Capabilities like percentage-based cropping are typically implemented via deterministic algorithms in libraries, not learned models.

## Usage Notes

- API Base URL: `https://api.eachlabs.ai/v1`
- Authentication: send `Authorization: Bearer YOUR_API_KEY`. Generate a key from the Eachlabs dashboard at https://www.eachlabs.ai/dashboard/api-keys.
- File-typed parameters (`*_url`, `image_url`, `video_url`, `audio_url`, etc.) accept publicly-reachable HTTPS URLs only. Upload your asset first (GCS / S3 / your CDN) and pass the resulting URL. Data-URIs and localhost URLs are rejected.
- For structured parameters (arrays / objects) send real JSON values, not stringified payloads.
- Monetary values are reported in USD; per-token / per-megapixel rates may be billed in micro-cents internally.
- Prefer `webhook_url` over polling for long-running predictions — see the Webhook Callback section.