Design

Эффект Маскирования Изображения

Применение эффектов маскирования к изображениям с использованием форм, градиентов или пользовательских масок для креативных композиций

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

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

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

cURL

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

# 2) Call the tool with the returned filePath values
curl -X POST 'https://api.elysiatools.com/ru/api/tools/image-add-masking' \
  -F 'imageFile=/path/to/file.ext' \
  -F 'maskType=shape' \
  -F 'maskShape=circle' \
  -F 'maskPosition=center' \
  -F 'maskSize=80' \
  -F 'featherRadius=0' \
  -F 'invertMask=false' \
  -F 'outputFormat=png' \
  -F 'quality=90'

Справочник API

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

Endpoint

HTTP

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

Параметры

Имя	Тип	Обязательный	Описание
imageFile	fileнужна загрузка	Да	Изображение для применения эффекта маски
maskType	select	Нет	Тип маски для применения
maskShape	select	Нет	Форма маски (когда тип маски - форма)
maskPosition	select	Нет	Позиция маски
maskSize	number	Нет	Размер маски в процентах от размеров изображения
featherRadius	number	Нет	Радиус мягкого края для маски (0 для жестких краев)
invertMask	checkbox	Нет	Инвертировать эффект маски (скрыть маскированную область вместо показа)
outputFormat	select	Нет	Формат вывода для результирующего изображения
quality	number	Нет	Качество вывода для форматов с потерями

Параметры типа «файл» необходимо сначала загрузить через POST /upload/image-add-masking, затем возвращённый 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-add-masking": {
      "name": "image-add-masking",
      "description": "Применение эффектов маскирования к изображениям с использованием форм, градиентов или пользовательских масок для креативных композиций",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-add-masking",
      "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-add-masking",
    "arguments": {
  "imageFile": "https://example.com/file.ext",
  "maskType": "shape",
  "maskShape": "circle",
  "maskPosition": "center",
  "maskSize": 80,
  "featherRadius": 0,
  "invertMask": false,
  "outputFormat": "png",
  "quality": 90
}
  }
}

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

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

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