Design

Обрезка изображения по цвету

Удаление определенных цветных границ и фонов с изображений путем обрезки пикселей, соответствующих выбранным цветам

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

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

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

cURL

# 1) Upload each file first → returns { filePath }
curl -X POST 'https://api.elysiatools.com/upload/image-trim-color' \
  -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-trim-color' \
  -F 'imageFile=/path/to/file.ext' \
  -F 'presetColors=white' \
  -F 'trimColor=Выберите цвет для обрезки...' \
  -F 'sampleFrom=false' \
  -F 'samplePosition=top-left' \
  -F 'colorTolerance=30' \
  -F 'analyzeOnly=false' \
  -F 'format=original' \
  -F 'quality=90'

Справочник API

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

Endpoint

HTTP

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

Параметры

Имя	Тип	Обязательный	Описание
imageFile	fileнужна загрузка	Да	Загрузите любой файл изображения (JPEG, PNG, WebP, TIFF) для обрезки по цвету
presetColors	select	Нет	Выберите общий цвет для обрезки
trimColor	color	Нет	Пользовательский цвет для обрезки границ изображения
sampleFrom	checkbox	Нет	Взять цвет для обрезки из определенной позиции на изображении
samplePosition	select	Нет	Откуда взять цвет из изображения
colorTolerance	range	Нет	Допуск для сопоставления цветов (0-50). Выше = больше цветов будет совпадать
analyzeOnly	checkbox	Нет	Анализировать изображение для поиска цветовых границ без создания обрезанного файла
format	select	Нет	Выберите формат вывода или сохраните оригинальный
quality	number	Нет	Качество вывода для форматов с потерями (JPEG, WebP). Выше = лучше качество, но больше размер файла

Параметры типа «файл» необходимо сначала загрузить через POST /upload/image-trim-color, затем возвращённый 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-trim-color": {
      "name": "image-trim-color",
      "description": "Удаление определенных цветных границ и фонов с изображений путем обрезки пикселей, соответствующих выбранным цветам",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-trim-color",
      "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-trim-color",
    "arguments": {
  "imageFile": "https://example.com/file.ext",
  "presetColors": "white",
  "trimColor": "Выберите цвет для обрезки...",
  "sampleFrom": false,
  "samplePosition": "top-left",
  "colorTolerance": 30,
  "analyzeOnly": false,
  "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]