Media

Batch Image Crop

Batch crop multiple images to specific dimensions or aspect ratios with custom positioning. Returns cropped images as a ZIP download.

file· File resultOpen tool

Quick start

Call this tool from your code in three languages.

cURL

# 1) Request a presigned URL → returns { uploadUrl, storageKey }
curl -X POST 'https://api.elysiatools.com/api/upload/presign/image-batch-crop' \
  -H 'Content-Type: application/json' \
  -d '{"filename":"imageFiles.ext","contentType":"application/octet-stream","size":12345}'

# 2) PUT the file bytes directly to the presigned uploadUrl
curl -X PUT '<presigned uploadUrl>' \
  --data-binary @/path/to/file.ext

# 3) Call the tool, passing the returned storageKey for each file field
curl -X POST 'https://api.elysiatools.com/en/api/tools/image-batch-crop' \
  -F 'imageFiles=uploads/2026/01/01/your-tool-1700000000000-abc123.ext' \
  -F 'cropMode=square' \
  -F 'aspectRatio=16:9' \
  -F 'width=0' \
  -F 'height=0' \
  -F 'gravity=center' \
  -F 'x=0' \
  -F 'y=0' \
  -F 'format=original' \
  -F 'quality=90' \
  -F 'keepOriginalNames=true'

Browse tools

Media

Batch Image Crop

Batch crop multiple images to specific dimensions or aspect ratios with custom positioning. Returns cropped images as a ZIP download.

file· File resultOpen tool

Quick start

Call this tool from your code in three languages.

cURL

# 1) Request a presigned URL → returns { uploadUrl, storageKey }
curl -X POST 'https://api.elysiatools.com/api/upload/presign/image-batch-crop' \
  -H 'Content-Type: application/json' \
  -d '{"filename":"imageFiles.ext","contentType":"application/octet-stream","size":12345}'

# 2) PUT the file bytes directly to the presigned uploadUrl
curl -X PUT '<presigned uploadUrl>' \
  --data-binary @/path/to/file.ext

# 3) Call the tool, passing the returned storageKey for each file field
curl -X POST 'https://api.elysiatools.com/en/api/tools/image-batch-crop' \
  -F 'imageFiles=uploads/2026/01/01/your-tool-1700000000000-abc123.ext' \
  -F 'cropMode=square' \
  -F 'aspectRatio=16:9' \
  -F 'width=0' \
  -F 'height=0' \
  -F 'gravity=center' \
  -F 'x=0' \
  -F 'y=0' \
  -F 'format=original' \
  -F 'quality=90' \
  -F 'keepOriginalNames=true'

Name	Type	Required	Description
imageFiles	fileupload required	Yes	—
cropMode	select	Yes	Choose how to crop images: square, aspect ratio, exact dimensions, or custom positioning
aspectRatio	select	No	Select a predefined aspect ratio for cropping
width	number	No	Set the exact width for cropped area
height	number	No	Set the exact height for cropped area
gravity	select	No	Choose where to position the crop area
x	number	No	Set the horizontal position for crop area (0 = left edge)
y	number	No	Set the vertical position for crop area (0 = top edge)
format	select	No	Choose output format or keep original
quality	number	No	Output quality for lossy formats
keepOriginalNames	checkbox	No	—

Batch Image Crop

Quick start

Batch Image Crop

Quick start

API reference

Endpoint

Parameters

Response format

MCP integration

Server configuration

List available tools

Call this tool