Elysia Tools Docs
RU
Язык
ZHESPTRUFRDEEN
На сайт
Обзор инструментов

Design

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

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

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

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

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

cURL
# 1) Request a presigned URL → returns { uploadUrl, storageKey }
curl -X POST 'https://api.elysiatools.com/api/upload/presign/image-composite' \
  -H 'Content-Type: application/json' \
  -d '{"filename":"baseImage.ext","contentType":"application/octet-stream","size":12345}'
curl -X POST 'https://api.elysiatools.com/api/upload/presign/image-composite' \
  -H 'Content-Type: application/json' \
  -d '{"filename":"compositeImages.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-composite' \
  -F 'baseImage=uploads/2026/01/01/your-tool-1700000000000-abc123.ext' \
  -F 'compositeImages=uploads/2026/01/01/your-tool-1700000000000-abc123.ext' \
  -F 'layoutMode=grid' \
  -F 'blendMode=over' \
  -F 'canvasWidth=0' \
  -F 'canvasHeight=0' \
  -F 'backgroundColor=transparent' \
  -F 'outputFormat=png' \
  -F 'quality=95'

© 2026 Elysia Tools. Документация для разработчиков.

На сайтОбзор инструментов

Справочник API

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

Endpoint

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

Параметры

ИмяТипОбязательныйОписание
baseImagefileнужна загрузкаДаБазовое изображение, на которое будут накладываться другие изображения
compositeImagesfileнужна загрузкаДаВыбрать 1-8 изображений для композиции на базовое изображение
layoutModeselectДаКак расположить компонуемые изображения
blendModeselectНетРежим смешивания для компонуемых изображений
canvasWidthnumberНетШирина финального холста (оставить пустым для использования ширины базового изображения)
canvasHeightnumberНетВысота финального холста (оставить пустым для использования высоты базового изображения)
backgroundColorcolorНетЦвет фона для прозрачных областей (по умолчанию: прозрачный)
outputFormatselectНетФормат вывода для композитного изображения
qualitynumberНетКачество вывода для форматов с потерями (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]

Обзор инструментов
Открыть инструмент