# Операции

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

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

| Группа | Операция | Запрос | Инструмент MCP | Единица цены |
|---|---|---|---|---|
| В PDF | [Word в PDF](https://dev.smartpdf.ru/docs/operations/word-to-pdf.md) | `POST /v1/pdf/word-to-pdf` | `word_to_pdf` | 10 МБ |
| В PDF | [JPG в PDF](https://dev.smartpdf.ru/docs/operations/jpg-to-pdf.md) | `POST /v1/pdf/jpg-to-pdf` | `jpg_to_pdf` | 10 МБ суммы файлов |
| В PDF | [Excel в PDF](https://dev.smartpdf.ru/docs/operations/xlsx-to-pdf.md) | `POST /v1/pdf/xlsx-to-pdf` | `xlsx_to_pdf` | 10 МБ |
| В PDF | [PowerPoint в PDF](https://dev.smartpdf.ru/docs/operations/pptx-to-pdf.md) | `POST /v1/pdf/pptx-to-pdf` | `pptx_to_pdf` | 10 МБ |
| В PDF | [HTML в PDF](https://dev.smartpdf.ru/docs/operations/html-to-pdf.md) | `POST /v1/pdf/html-to-pdf` | `html_to_pdf` | 10 МБ |
| Из PDF | [PDF в Word](https://dev.smartpdf.ru/docs/operations/pdf-to-word.md) | `POST /v1/pdf/to-word` | `pdf_to_word` | 10 МБ или 50 стр. |
| Из PDF | [PDF в JPG](https://dev.smartpdf.ru/docs/operations/pdf-to-jpg.md) | `POST /v1/pdf/to-jpg` | `pdf_to_jpg` | 10 МБ или 50 стр. (300 dpi — 25) |
| Из PDF | [PDF в Excel](https://dev.smartpdf.ru/docs/operations/pdf-to-excel.md) | `POST /v1/pdf/to-excel` | `pdf_to_excel` | 10 МБ или 50 стр. |
| Из PDF | [PDF в PowerPoint](https://dev.smartpdf.ru/docs/operations/pdf-to-pptx.md) | `POST /v1/pdf/to-pptx` | `pdf_to_pptx` | 10 МБ или 50 стр. |
| Из PDF | [PDF в текст](https://dev.smartpdf.ru/docs/operations/pdf-to-txt.md) | `POST /v1/pdf/to-txt` | `pdf_to_txt` | 10 МБ |
| Управление | [Сжать PDF](https://dev.smartpdf.ru/docs/operations/compress.md) | `POST /v1/pdf/compress` | `compress_pdf` | 10 МБ |
| Управление | [Объединить PDF](https://dev.smartpdf.ru/docs/operations/merge.md) | `POST /v1/pdf/merge` | `merge_pdfs` | 10 МБ суммы файлов |
| Управление | [Разделить PDF](https://dev.smartpdf.ru/docs/operations/split.md) | `POST /v1/pdf/split` | `split_pdf` | 10 МБ |
| Управление | [Распознать текст](https://dev.smartpdf.ru/docs/operations/ocr.md) | `POST /v1/pdf/ocr` | `ocr_pdf` | 10 МБ или 10 стр. |
| Управление | [Сгладить PDF](https://dev.smartpdf.ru/docs/operations/flatten.md) | `POST /v1/pdf/flatten` | `flatten_pdf` | 10 МБ |
| Страницы | [Удалить страницы](https://dev.smartpdf.ru/docs/operations/delete-pages.md) | `POST /v1/pdf/delete-pages` | `delete_pages` | 10 МБ |
| Страницы | [Извлечь страницы](https://dev.smartpdf.ru/docs/operations/extract-pages.md) | `POST /v1/pdf/extract-pages` | `extract_pages` | 10 МБ |
| Страницы | [Повернуть страницы](https://dev.smartpdf.ru/docs/operations/rotate.md) | `POST /v1/pdf/rotate` | `rotate_pdf` | 10 МБ |
| Страницы | [Порядок страниц](https://dev.smartpdf.ru/docs/operations/reorder-pages.md) | `POST /v1/pdf/reorder-pages` | `reorder_pages` | 10 МБ |
| Страницы | [Нумерация страниц](https://dev.smartpdf.ru/docs/operations/add-page-numbers.md) | `POST /v1/pdf/add-page-numbers` | `add_page_numbers` | 10 МБ |
| Подпись и защита | [Подписать PDF](https://dev.smartpdf.ru/docs/operations/sign.md) | `POST /v1/pdf/sign` | `sign_pdf` | 10 МБ |
| Подпись и защита | [Защитить паролем](https://dev.smartpdf.ru/docs/operations/protect.md) | `POST /v1/pdf/protect` | `protect_pdf` | 10 МБ |
| Подпись и защита | [Снять пароль](https://dev.smartpdf.ru/docs/operations/unlock.md) | `POST /v1/pdf/unlock` | `unlock_pdf` | 10 МБ |
| Подпись и защита | [Водяной знак](https://dev.smartpdf.ru/docs/operations/watermark.md) | `POST /v1/pdf/watermark` | `watermark_pdf` | 10 МБ |

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

У всех операций есть необязательный `webhook_url` — https-адрес: по завершении SmartPDF отправит на него `POST` с результатом и подписью. Подробно — [Вебхуки](https://dev.smartpdf.ru/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://dev.smartpdf.ru/docs/upload): новый `file_id`, который действует час. Так можно, например, распознать текст в скане, а потом сжать результат. Работает только для результатов в PDF (иначе `422`), до завершения операции — `409`, после удаления результата — `410`. На бесплатном тарифе это не тратит единственную ссылку на скачивание. Каждая операция цепочки оплачивается отдельно.