Design

Редактор Обрезки Изображений

Обрезайте изображения до определенных размеров или соотношения сторон с настраиваемым позиционированием

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

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

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

cURL

# 1) Request a presigned URL → returns { uploadUrl, storageKey }
curl -X POST 'https://api.elysiatools.com/api/upload/presign/image-cropper' \
  -H 'Content-Type: application/json' \
  -d '{"filename":"imageFile.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/ru/api/tools/image-cropper' \
  -F 'imageFile=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'

Справочник API

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

Endpoint

HTTP

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

Параметры

Имя	Тип	Обязательный	Описание
imageFile	fileнужна загрузка	Да	Загрузите любой файл изображения (JPEG, PNG, WebP, GIF, BMP, TIFF) для обрезки
cropMode	select	Да	Выберите способ обрезки: квадрат, соотношение сторон, точные размеры или пользовательское позиционирование
aspectRatio	select	Нет	Выберите предопределенное соотношение сторон для обрезки. Изображение будет обрезано до соответствия этому соотношению
width	number	Нет	Установите точную ширину области обрезки. Будет ограничена шириной изображения если больше
height	number	Нет	Установите точную высоту области обрезки. Будет ограничена высотой изображения если больше
gravity	select	Нет	Choose where to position the crop area. Works with all crop modes
x	number	Нет	Установите горизонтальную позицию области обрезки (0 = левый край). Будет скорректирована если выходит за границы изображения
y	number	Нет	Установите вертикальную позицию области обрезки (0 = верхний край). Будет скорректирована если выходит за границы изображения
format	select	Нет	Выберите формат вывода или оставьте оригинал. Преобразование в JPEG может снизить качество прозрачности
quality	number	Нет	Качество вывода для форматов с потерями (JPEG, WebP). Выше = лучше качество но больше размер файла

Параметры типа «файл» необходимо сначала загрузить через POST /upload/image-cropper, затем возвращённый 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-cropper": {
      "name": "image-cropper",
      "description": "Обрезайте изображения до определенных размеров или соотношения сторон с настраиваемым позиционированием",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-cropper",
      "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-cropper",
    "arguments": {
  "imageFile": "https://example.com/file.ext",
  "cropMode": "square",
  "aspectRatio": "16:9",
  "width": 0,
  "height": 0,
  "gravity": "center",
  "x": 0,
  "y": 0,
  "format": "original",
  "quality": 90
}
  }
}

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

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

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