Media

Расширитель Холста Изображения

Базовый инструмент расширения холста изображения для добавления пространства вокруг изображений с различными стратегиями заполнения

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

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

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

cURL

# 1) Upload each file first → returns { filePath }
curl -X POST 'https://api.elysiatools.com/upload/image-extend' \
  -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-extend' \
  -F 'imageFile=/path/to/file.ext' \
  -F 'extendMode=uniform' \
  -F 'extendWith=background' \
  -F 'backgroundColor=#ffffff' \
  -F 'uniformPadding=50' \
  -F 'topPadding=0' \
  -F 'rightPadding=0' \
  -F 'bottomPadding=0' \
  -F 'leftPadding=0' \
  -F 'format=original' \
  -F 'quality=90'

Справочник API

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

Endpoint

HTTP

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

Параметры

Имя	Тип	Обязательный	Описание
imageFile	fileнужна загрузка	Да	Загрузите любой файл изображения (JPEG, PNG, WebP, TIFF, GIF, BMP)
extendMode	select	Да	Выберите, как расширить холст изображения
extendWith	select	Да	Выберите, как заполнить расширенную область
backgroundColor	color	Нет	Цвет фона для расширенной области (по умолчанию: белый)
uniformPadding	number	Нет	Отступ для добавления на всех сторонах при использовании равномерного режима
topPadding	number	Нет	Отступ для добавления к верхнему краю
rightPadding	number	Нет	Отступ для добавления к правому краю
bottomPadding	number	Нет	Отступ для добавления к нижнему краю
leftPadding	number	Нет	Отступ для добавления к левому краю
format	select	Нет	Выберите формат вывода или сохраните оригинал
quality	number	Нет	Качество вывода для форматов с потерями (JPEG, WebP). Выше = лучше качество но больше файл

Параметры типа «файл» необходимо сначала загрузить через POST /upload/image-extend, затем возвращённый 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-extend": {
      "name": "image-extend",
      "description": "Базовый инструмент расширения холста изображения для добавления пространства вокруг изображений с различными стратегиями заполнения",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-extend",
      "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-extend",
    "arguments": {
  "imageFile": "https://example.com/file.ext",
  "extendMode": "uniform",
  "extendWith": "background",
  "backgroundColor": "#ffffff",
  "uniformPadding": 50,
  "topPadding": 0,
  "rightPadding": 0,
  "bottomPadding": 0,
  "leftPadding": 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]