Операции · Изображения

Изменить размер фото

Меняет размер фото в процентах или пикселях, формат сохраняется. Одно фото — файл, несколько — ZIP-архив.

Запрос
POST /v1/pdf/resize-image
Инструмент MCP
resize_image
Вход
JPG, PNG, WEBP, HEIC, TIFF, BMP — до 10 файлов на бесплатном тарифе, 20 на Про, 50 на Бизнесе
Результат
Тот же формат (HEIC — JPG); несколько — ZIP
Единица цены
10 МБ суммы файлов — как считается

Параметры

Тело запроса — JSON. Лишние поля API игнорирует.

ПараметрТипОписание
file_idsобязательныйstring[]file_id загруженных файлов (POST /v1/upload) — в нужном порядке.
modestringpercent — масштаб percent; pixels — width и/или height.Значения: "percent", "pixels"По умолчанию: "percent"
percentnumberМасштаб, %: от 1 до 500.По умолчанию: 50
widthintegerШирина, пикселей: до 10 000.
heightintegerВысота, пикселей: до 10 000.
keep_aspectbooleanСохранить пропорции: при width и height — по меньшему масштабу.По умолчанию: true
enlargebooleanРазрешить увеличение. Без него фото меньше заданного размера не растягиваются.По умолчанию: false
webhook_urlstringhttps-адрес: по завершении SmartPDF отправит на него POST с результатом и подписью — вместо опроса статуса (раздел «Вебхуки»).

Запрос

Это шаг 2 полного цикла: файл уже загружен, а статус и скачивание — как в быстром старте. Функция call и переменные — оттуда же.

POST /v1/pdf/resize-image
BODY=$(jq -n --arg file_id_1 "$FILE_ID_1" '{file_ids: [$file_id_1], mode: "pixels", width: 1200}')
curl -sS --fail-with-body -H "X-API-Key: $SMARTPDF_API_KEY" -H "Content-Type: application/json" \
  -d "$BODY" https://api.smartpdf.ru/v1/pdf/resize-image

Ответ

202 Accepted — операция оплачена и поставлена в очередь. Дальше — опрос GET /v1/tasks/{task_id} или вебхук.

202 Accepted
{
  "task_id": "3f2c5b0e-8a41-4d7e-9c1f-5d0b8f2e7a64"
}

Эта страница для агентов: Markdown · llms.txt