Design

Композиция Изображений

Композиция нескольких изображений вместе с точным контролем положения, непрозрачности и режимов смешивания

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

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

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

cURL

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

# 2) Call the tool with the returned filePath values
curl -X POST 'https://api.elysiatools.com/ru/api/tools/image-composite' \
  -F 'baseImage=/path/to/file.ext' \
  -F 'compositeImages=/path/to/file.ext' \
  -F 'layoutMode=grid' \
  -F 'blendMode=over' \
  -F 'canvasWidth=0' \
  -F 'canvasHeight=0' \
  -F 'backgroundColor=transparent' \
  -F 'outputFormat=png' \
  -F 'quality=95'

Справочник API

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

Endpoint

HTTP

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

Параметры

Имя	Тип	Обязательный	Описание
baseImage	fileнужна загрузка	Да	Базовое изображение, на которое будут накладываться другие изображения
compositeImages	fileнужна загрузка	Да	Выбрать 1-8 изображений для композиции на базовое изображение
layoutMode	select	Да	Как расположить компонуемые изображения
blendMode	select	Нет	Режим смешивания для компонуемых изображений
canvasWidth	number	Нет	Ширина финального холста (оставить пустым для использования ширины базового изображения)
canvasHeight	number	Нет	Высота финального холста (оставить пустым для использования высоты базового изображения)
backgroundColor	color	Нет	Цвет фона для прозрачных областей (по умолчанию: прозрачный)
outputFormat	select	Нет	Формат вывода для композитного изображения
quality	number	Нет	Качество вывода для форматов с потерями (JPEG, WebP, AVIF)

Параметры типа «файл» необходимо сначала загрузить через POST /upload/image-composite, затем возвращённый 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-composite": {
      "name": "image-composite",
      "description": "Композиция нескольких изображений вместе с точным контролем положения, непрозрачности и режимов смешивания",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-composite",
      "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-composite",
    "arguments": {
  "baseImage": "https://example.com/file.ext",
  "compositeImages": "https://example.com/file.ext",
  "layoutMode": "grid",
  "blendMode": "over",
  "canvasWidth": 0,
  "canvasHeight": 0,
  "backgroundColor": "transparent",
  "outputFormat": "png",
  "quality": 95
}
  }
}

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

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

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