Media

Пакетная Обрезка Изображений

Пакетная обрезка нескольких изображений до определенных размеров или соотношения сторон с настраиваемым позиционированием. Возвращает обрезанные изображения в виде ZIP-архива.

file· Файловый результатОткрыть инструмент

Быстрый старт

Вызовите этот инструмент из своего кода на трёх языках.

cURL

# 1) Upload each file first → returns { filePath }
curl -X POST 'https://api.elysiatools.com/upload/image-batch-crop' \
  -F 'file=@/path/to/imageFiles.ext'

# 2) Call the tool with the returned filePath values
curl -X POST 'https://api.elysiatools.com/ru/api/tools/image-batch-crop' \
  -F 'imageFiles=photo.jpg' \
  -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'

Справочник API

Отправьте POST-запрос с входными данными в JSON. Параметры типа «файл» требуют предварительной загрузки.

Endpoint

HTTP

POST https://api.elysiatools.com/ru/api/tools/image-batch-crop

Параметры

Имя	Тип	Обязательный	Описание
imageFiles	fileнужна загрузка	Да	—
cropMode	select	Да	Выберите способ обрезки изображений: квадрат, соотношение сторон, точные размеры или пользовательское позиционирование
aspectRatio	select	Нет	Выберите предопределенное соотношение сторон для обрезки
width	number	Нет	Set the exact width for cropped area
height	number	Нет	Set the exact height for cropped area
gravity	select	Нет	Выберите где позиционировать область обрезки
x	number	Нет	Установить горизонтальную позицию области обрезки (0 = левый край)
y	number	Нет	Установить вертикальную позицию области обрезки (0 = верхний край)
format	select	Нет	Выберите формат вывода или сохраните оригинал
quality	number	Нет	Output quality for lossy formats
keepOriginalNames	checkbox	Нет	—

Параметры типа «файл» необходимо сначала загрузить через POST /upload/image-batch-crop, затем возвращённый filePath передаётся в соответствующее поле.

Формат ответа

Файловый результат

JSON

{
  "filePath": "/public/processing/randomid.ext",
  "fileName": "output.ext",
  "contentType": "application/octet-stream",
  "size": 1024,
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}

Интеграция MCP

Добавьте этот инструмент на свой сервер Model Context Protocol, чтобы ИИ-агенты могли перечислять и вызывать его.

Конфигурация сервера

Добавьте этот блок в конфигурацию вашего MCP-клиента:

mcp.json

{
  "mcpServers": {
    "elysiatools-image-batch-crop": {
      "name": "image-batch-crop",
      "description": "Пакетная обрезка нескольких изображений до определенных размеров или соотношения сторон с настраиваемым позиционированием. Возвращает обрезанные изображения в виде ZIP-архива.",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-batch-crop",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Получить список инструментов

После подключения к SSE-endpoint выведите список доступных инструментов:

tools/list

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

Вызвать этот инструмент

Вызовите инструмент по его id; аргументы формируются из его параметров:

tools/call

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "image-batch-crop",
    "arguments": {
  "imageFiles": [
    "photo.jpg"
  ],
  "cropMode": "square",
  "aspectRatio": "16:9",
  "width": 0,
  "height": 0,
  "gravity": "center",
  "x": 0,
  "y": 0,
  "format": "original",
  "quality": 90,
  "keepOriginalNames": true
}
  }
}

Объединяйте несколько инструментов в одной сессии списком toolId через запятую, напр. /mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp (макс. 20).

Файловые параметры принимают только публичный URL файла (https://…). Локальные пути, data: URI и строки Base64 не поддерживаются.

Вопросы или проблемы? Свяжитесь с [email protected]