PDF Tools

Выравнивание PDF

Автоматически обнаруживает и исправляет перекошенные страницы PDF. Сохраняет текстовые страницы как доступный для поиска векторный контент и растеризует только страницы-изображения (например, сканы).

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

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

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

cURL

# 1) Request a presigned URL → returns { uploadUrl, storageKey }
curl -X POST 'https://api.elysiatools.com/api/upload/presign/pdf-deskew' \
  -H 'Content-Type: application/json' \
  -d '{"filename":"sourceFile.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/pdf-deskew' \
  -F 'sourceFile=/public/samples/pdf/sample-multipage.pdf' \
  -F 'mode=auto' \
  -F 'manualAngle=0' \
  -F 'threshold=0.5' \
  -F 'rasterizeText=false' \
  -F 'pageRange='

Справочник API

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

Endpoint

HTTP

POST https://api.elysiatools.com/ru/api/tools/pdf-deskew

Параметры

Имя	Тип	Обязательный	Описание
sourceFile	fileнужна загрузка	Да	—
mode	select	Да	—
manualAngle	number	Нет	Ручной угол коррекции (градусы). Положительное значение корректирует перекос по часовой. Только в ручном режиме.
threshold	number	Нет	Минимальный обнаруженный угол перекоса (в градусах), необходимый для применения коррекции в автоматическом режиме. Меньшие значения обнаруживают слабые перекосы.
rasterizeText	select	Нет	По умолчанию текстовые страницы сохраняются как доступный для поиска векторный контент (без выравнивания). Включайте только если нужно выровнять векторный текстовый контент, принимая потерю возможности выделения текста.
pageRange	text	Нет	Укажите страницы для выравнивания (например, 1-3,5,7-9). Оставьте пустым для всех.

Параметры типа «файл» необходимо сначала загрузить через POST /upload/pdf-deskew, затем возвращённый 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-pdf-deskew": {
      "name": "pdf-deskew",
      "description": "Автоматически обнаруживает и исправляет перекошенные страницы PDF. Сохраняет текстовые страницы как доступный для поиска векторный контент и растеризует только страницы-изображения (например, сканы).",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=pdf-deskew",
      "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": "pdf-deskew",
    "arguments": {
  "sourceFile": "/public/samples/pdf/sample-multipage.pdf",
  "mode": "auto",
  "manualAngle": 0,
  "threshold": 0.5,
  "rasterizeText": "false",
  "pageRange": ""
}
  }
}

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

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

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