# Операции

Источник: https://smartpdf.ru/developers/docs/operations

Каждая операция — `POST /v1/pdf/<операция>` с JSON: `file_id` загруженного файла (или `file_ids` — у операций над несколькими файлами: объединение, фото и картинки) и параметры. Ответ — `202` и `task_id`, дальше — [статус и скачивание](https://smartpdf.ru/developers/docs/tasks).

| Группа | Операция | Запрос | Инструмент MCP | Единица цены |
|---|---|---|---|---|
| В PDF | [Word в PDF](https://smartpdf.ru/developers/docs/operations/word-to-pdf.md) | `POST /v1/pdf/word-to-pdf` | `word_to_pdf` | 10 МБ |
| В PDF | [JPG в PDF](https://smartpdf.ru/developers/docs/operations/jpg-to-pdf.md) | `POST /v1/pdf/jpg-to-pdf` | `jpg_to_pdf` | 10 МБ суммы файлов |
| В PDF | [Фото в PDF](https://smartpdf.ru/developers/docs/operations/photo-to-pdf.md) | `POST /v1/pdf/photo-to-pdf` | `photo_to_pdf` | 10 МБ суммы файлов |
| В PDF | [Excel в PDF](https://smartpdf.ru/developers/docs/operations/xlsx-to-pdf.md) | `POST /v1/pdf/xlsx-to-pdf` | `xlsx_to_pdf` | 10 МБ |
| В PDF | [PowerPoint в PDF](https://smartpdf.ru/developers/docs/operations/pptx-to-pdf.md) | `POST /v1/pdf/pptx-to-pdf` | `pptx_to_pdf` | 10 МБ |
| В PDF | [DjVu в PDF](https://smartpdf.ru/developers/docs/operations/djvu-to-pdf.md) | `POST /v1/pdf/djvu-to-pdf` | `djvu_to_pdf` | 10 МБ |
| В PDF | [FB2 в PDF](https://smartpdf.ru/developers/docs/operations/fb2-to-pdf.md) | `POST /v1/pdf/fb2-to-pdf` | `fb2_to_pdf` | 10 МБ |
| В PDF | [EPUB в PDF](https://smartpdf.ru/developers/docs/operations/epub-to-pdf.md) | `POST /v1/pdf/epub-to-pdf` | `epub_to_pdf` | 10 МБ |
| В PDF | [HTML в PDF](https://smartpdf.ru/developers/docs/operations/html-to-pdf.md) | `POST /v1/pdf/html-to-pdf` | `html_to_pdf` | 10 МБ |
| Из PDF | [PDF в Word](https://smartpdf.ru/developers/docs/operations/pdf-to-word.md) | `POST /v1/pdf/to-word` | `pdf_to_word` | 10 МБ или 50 стр. |
| Из PDF | [PDF в JPG](https://smartpdf.ru/developers/docs/operations/pdf-to-jpg.md) | `POST /v1/pdf/to-jpg` | `pdf_to_jpg` | 10 МБ или 50 стр. (300 dpi — 25) |
| Из PDF | [PDF в PNG](https://smartpdf.ru/developers/docs/operations/pdf-to-png.md) | `POST /v1/pdf/to-png` | `pdf_to_png` | 10 МБ |
| Из PDF | [PDF в Excel](https://smartpdf.ru/developers/docs/operations/pdf-to-excel.md) | `POST /v1/pdf/to-excel` | `pdf_to_excel` | 10 МБ или 50 стр. |
| Из PDF | [PDF в PowerPoint](https://smartpdf.ru/developers/docs/operations/pdf-to-pptx.md) | `POST /v1/pdf/to-pptx` | `pdf_to_pptx` | 10 МБ или 50 стр. |
| Из PDF | [PDF в Markdown](https://smartpdf.ru/developers/docs/operations/pdf-to-markdown.md) | `POST /v1/pdf/to-markdown` | `pdf_to_markdown` | 10 МБ или 50 стр. |
| Из PDF | [PDF в текст](https://smartpdf.ru/developers/docs/operations/pdf-to-txt.md) | `POST /v1/pdf/to-txt` | `pdf_to_txt` | 10 МБ |
| Изображения | [Сжать фото](https://smartpdf.ru/developers/docs/operations/compress-image.md) | `POST /v1/pdf/compress-image` | `compress_image` | 10 МБ суммы файлов |
| Изображения | [HEIC в JPG](https://smartpdf.ru/developers/docs/operations/heic-to-jpg.md) | `POST /v1/pdf/heic-to-jpg` | `heic_to_jpg` | 10 МБ суммы файлов |
| Изображения | [Фото в текст](https://smartpdf.ru/developers/docs/operations/image-to-text.md) | `POST /v1/pdf/image-to-text` | `image_to_text` | 10 МБ суммы файлов или 10 фото |
| Изображения | [PNG в JPG](https://smartpdf.ru/developers/docs/operations/png-to-jpg.md) | `POST /v1/pdf/png-to-jpg` | `png_to_jpg` | 10 МБ суммы файлов |
| Изображения | [JPG в PNG](https://smartpdf.ru/developers/docs/operations/jpg-to-png.md) | `POST /v1/pdf/jpg-to-png` | `jpg_to_png` | 10 МБ суммы файлов |
| Изображения | [WEBP в JPG](https://smartpdf.ru/developers/docs/operations/webp-to-jpg.md) | `POST /v1/pdf/webp-to-jpg` | `webp_to_jpg` | 10 МБ суммы файлов |
| Изображения | [Изменить размер фото](https://smartpdf.ru/developers/docs/operations/resize-image.md) | `POST /v1/pdf/resize-image` | `resize_image` | 10 МБ суммы файлов |
| Изображения | [Обрезать фото](https://smartpdf.ru/developers/docs/operations/crop-image.md) | `POST /v1/pdf/crop-image` | `crop_image` | 10 МБ |
| Изображения | [Повернуть фото](https://smartpdf.ru/developers/docs/operations/rotate-image.md) | `POST /v1/pdf/rotate-image` | `rotate_image` | 10 МБ суммы файлов |
| Изображения | [Word в JPG](https://smartpdf.ru/developers/docs/operations/word-to-jpg.md) | `POST /v1/pdf/word-to-jpg` | `word_to_jpg` | 10 МБ |
| Управление | [Редактор PDF](https://smartpdf.ru/developers/docs/operations/edit.md) | `POST /v1/pdf/edit` | `edit_pdf` | 10 МБ |
| Управление | [Сжать PDF](https://smartpdf.ru/developers/docs/operations/compress.md) | `POST /v1/pdf/compress` | `compress_pdf` | 10 МБ |
| Управление | [PDF в ч/б](https://smartpdf.ru/developers/docs/operations/grayscale.md) | `POST /v1/pdf/grayscale` | `grayscale_pdf` | 10 МБ |
| Управление | [PDF в PDF/A](https://smartpdf.ru/developers/docs/operations/to-pdfa.md) | `POST /v1/pdf/to-pdfa` | `pdf_to_pdfa` | 10 МБ |
| Управление | [Восстановить PDF](https://smartpdf.ru/developers/docs/operations/repair.md) | `POST /v1/pdf/repair` | `repair_pdf` | 10 МБ |
| Управление | [Объединить PDF](https://smartpdf.ru/developers/docs/operations/merge.md) | `POST /v1/pdf/merge` | `merge_pdfs` | 10 МБ суммы файлов |
| Управление | [Разделить PDF](https://smartpdf.ru/developers/docs/operations/split.md) | `POST /v1/pdf/split` | `split_pdf` | 10 МБ |
| Управление | [Распознать текст](https://smartpdf.ru/developers/docs/operations/ocr.md) | `POST /v1/pdf/ocr` | `ocr_pdf` | 10 МБ или 10 стр. |
| Управление | [Сгладить PDF](https://smartpdf.ru/developers/docs/operations/flatten.md) | `POST /v1/pdf/flatten` | `flatten_pdf` | 10 МБ |
| Страницы | [Удалить страницы](https://smartpdf.ru/developers/docs/operations/delete-pages.md) | `POST /v1/pdf/delete-pages` | `delete_pages` | 10 МБ |
| Страницы | [Обрезать PDF](https://smartpdf.ru/developers/docs/operations/crop.md) | `POST /v1/pdf/crop` | `crop_pdf` | 10 МБ |
| Страницы | [Извлечь страницы](https://smartpdf.ru/developers/docs/operations/extract-pages.md) | `POST /v1/pdf/extract-pages` | `extract_pages` | 10 МБ |
| Страницы | [Повернуть страницы](https://smartpdf.ru/developers/docs/operations/rotate.md) | `POST /v1/pdf/rotate` | `rotate_pdf` | 10 МБ |
| Страницы | [Порядок страниц](https://smartpdf.ru/developers/docs/operations/reorder-pages.md) | `POST /v1/pdf/reorder-pages` | `reorder_pages` | 10 МБ |
| Страницы | [Нумерация страниц](https://smartpdf.ru/developers/docs/operations/add-page-numbers.md) | `POST /v1/pdf/add-page-numbers` | `add_page_numbers` | 10 МБ |
| Подпись и защита | [Подписать PDF](https://smartpdf.ru/developers/docs/operations/sign.md) | `POST /v1/pdf/sign` | `sign_pdf` | 10 МБ |
| Подпись и защита | [Защитить паролем](https://smartpdf.ru/developers/docs/operations/protect.md) | `POST /v1/pdf/protect` | `protect_pdf` | 10 МБ |
| Подпись и защита | [Снять пароль](https://smartpdf.ru/developers/docs/operations/unlock.md) | `POST /v1/pdf/unlock` | `unlock_pdf` | 10 МБ |
| Подпись и защита | [Скрыть персональные данные](https://smartpdf.ru/developers/docs/operations/redact.md) | `POST /v1/pdf/redact` | `redact_pdf` | 10 МБ |
| Подпись и защита | [Найти персональные данные](https://smartpdf.ru/developers/docs/operations/find-personal-data.md) | `POST /v1/pdf/find-personal-data` | `find_personal_data` | 10 МБ |
| Подпись и защита | [Водяной знак](https://smartpdf.ru/developers/docs/operations/watermark.md) | `POST /v1/pdf/watermark` | `watermark_pdf` | 10 МБ |

## Общий параметр

У всех операций есть необязательный `webhook_url` — https-адрес: по завершении SmartPDF отправит на него `POST` с результатом и подписью. Подробно — [Вебхуки](https://smartpdf.ru/developers/docs/webhooks).

## Цепочки операций

PDF-результат одной операции можно сразу передать в следующую — без скачивания и повторной загрузки:

```bash
curl -X POST https://api.smartpdf.ru/v1/upload/from-task/$TASK_ID -H "X-API-Key: $SMARTPDF_API_KEY"
```

Ответ — как у [загрузки](https://smartpdf.ru/developers/docs/upload): новый `file_id`, который действует час. Так можно, например, распознать текст в скане, а потом сжать результат. Работает только для результатов в PDF (иначе `422`), до завершения операции — `409`, после удаления результата — `410`. На бесплатном тарифе это не тратит единственную ссылку на скачивание. Каждая операция цепочки оплачивается отдельно.