Batch Crop Images
Crop the same pixel rectangle from multiple images and receive valid outputs in one ZIP.
POST /api/free/batch-crop-imagesUse Batch Crop Images online
Upload and manage a batch without entering an API key. Running the job requires a signed-in paid account.
1. Upload and settings
Use this tool online without an API key. Files are sent only when you run the request.
2. Preview and download
Preview, size changes and download controls are shown here
When to use this batch API
A batch image crop API removes the same coordinate-based rectangle from every accepted image. Each source is checked independently because image dimensions may differ.
Common workflows
- Extract a consistent subject region from studio images.
- Trim exported screenshots that share the same canvas layout.
- Create fixed crop variants for publishing pipelines.
- 01Upload the images you want to process with Batch Crop Images.
- 02Choose one shared parameter set for the whole batch.
- 03Run the job, review per-file status, and download the ZIP or JSON result.
Use repeated files fields, then set Image files, Left offset, Top offset, Crop width, Crop height, Output format. Each source image is checked independently to ensure the shared crop rectangle stays in bounds.
Related single-image API
Use the single-image endpoint for free one-off processing, or this paid batch endpoint for repeatable multi-file work.
Crop ImageIntegrate with the API
Programmatic batch calls require an API key owned by a paid account. One batch request counts as one API request.
POST /api/free/batch-crop-imagesUse an APIAny key from a paid account. The API accepts up to 20 files and 100 MB total per request.
- Each source image is checked independently to ensure the shared crop rectangle stays in bounds.
- Out-of-bounds images are reported in manifest.json while valid images remain downloadable.
Response
A successful request returns a zip response with the Content-Type described by this page.
Common errors
- 400
- A file or parameter is missing, invalid or outside the documented limit.
- 401
- The API key is missing, invalid or disabled for programmatic API calls.
- 429
- The online or authenticated shared rate limit has been reached.
Parameters and limits
| Parameter | Requirement | Default | Accepted values |
|---|---|---|---|
filesImage files | Required | — | file |
leftLeft offset | Required | 0 | number |
topTop offset | Required | 0 | number |
widthCrop width | Required | 500 | number |
heightCrop height | Required | 500 | number |
formatOutput format | Optional | webp | webp, png, jpeg |
API example
Use this authenticated example in code. The online Playground above intentionally does not request or expose your key.
curl -X POST "https://apiany.ai/api/free/batch-crop-images" \ -H "Authorization: Bearer $API_KEY" \ -F "files=@a.png" \ -F "files=@b.jpg" \ -F "left=0" \ -F "top=0" \ -F "width=500" \ -F "height=500" \ -F "format=webp" \ --output cropped-images.zip
Frequently asked questions
Who can run Batch Crop Images?
The page is public, but online execution requires a paid login and API calls require a paid account key.
What are the Batch Crop Images file limits?
Online jobs accept 10 files and 50 MB total; API jobs accept 20 files and 100 MB total; each file can be 30 MB.
What does Batch Crop Images return?
It returns ZIP + manifest.json. Out-of-bounds images are reported in manifest.json while valid images remain downloadable.
Can Batch Crop Images finish when one file fails?
Yes. Files are processed independently, successful results remain available, and failed items include an error code.