Операции
Каждая операция — POST /v1/pdf/<операция> с JSON: file_id загруженного файла (или file_ids — у объединения и сборки из изображений) и параметры. Ответ — 202 и task_id, дальше — статус и скачивание.
| Операция | Запрос | Инструмент MCP | Единица цены |
|---|---|---|---|
| В PDF | |||
| Word в PDF | POST /v1/pdf/word-to-pdf | word_to_pdf | 10 МБ |
| JPG в PDF | POST /v1/pdf/jpg-to-pdf | jpg_to_pdf | 10 МБ суммы файлов |
| Excel в PDF | POST /v1/pdf/xlsx-to-pdf | xlsx_to_pdf | 10 МБ |
| PowerPoint в PDF | POST /v1/pdf/pptx-to-pdf | pptx_to_pdf | 10 МБ |
| HTML в PDF | POST /v1/pdf/html-to-pdf | html_to_pdf | 10 МБ |
| Из PDF | |||
| PDF в Word | POST /v1/pdf/to-word | pdf_to_word | 10 МБ или 50 стр. |
| PDF в JPG | POST /v1/pdf/to-jpg | pdf_to_jpg | 10 МБ или 50 стр. (300 dpi — 25) |
| PDF в Excel | POST /v1/pdf/to-excel | pdf_to_excel | 10 МБ или 50 стр. |
| PDF в PowerPoint | POST /v1/pdf/to-pptx | pdf_to_pptx | 10 МБ или 50 стр. |
| PDF в текст | POST /v1/pdf/to-txt | pdf_to_txt | 10 МБ |
| Управление | |||
| Сжать PDF | POST /v1/pdf/compress | compress_pdf | 10 МБ |
| Объединить PDF | POST /v1/pdf/merge | merge_pdfs | 10 МБ суммы файлов |
| Разделить PDF | POST /v1/pdf/split | split_pdf | 10 МБ |
| Распознать текст | POST /v1/pdf/ocr | ocr_pdf | 10 МБ или 10 стр. |
| Сгладить PDF | POST /v1/pdf/flatten | flatten_pdf | 10 МБ |
| Страницы | |||
| Удалить страницы | POST /v1/pdf/delete-pages | delete_pages | 10 МБ |
| Извлечь страницы | POST /v1/pdf/extract-pages | extract_pages | 10 МБ |
| Повернуть страницы | POST /v1/pdf/rotate | rotate_pdf | 10 МБ |
| Порядок страниц | POST /v1/pdf/reorder-pages | reorder_pages | 10 МБ |
| Нумерация страниц | POST /v1/pdf/add-page-numbers | add_page_numbers | 10 МБ |
| Подпись и защита | |||
| Подписать PDF | POST /v1/pdf/sign | sign_pdf | 10 МБ |
| Защитить паролем | POST /v1/pdf/protect | protect_pdf | 10 МБ |
| Снять пароль | POST /v1/pdf/unlock | unlock_pdf | 10 МБ |
| Водяной знак | POST /v1/pdf/watermark | watermark_pdf | 10 МБ |
Общий параметр
У всех операций есть необязательный webhook_url — https-адрес: по завершении SmartPDF отправит на него POST с результатом и подписью. Подробно — Вебхуки.
Цепочки операций
PDF-результат одной операции можно сразу передать в следующую — без скачивания и повторной загрузки:
curl -X POST https://api.smartpdf.ru/v1/upload/from-task/$TASK_ID -H "X-API-Key: $SMARTPDF_API_KEY"Ответ — как у загрузки: новый file_id, который действует час. Так можно, например, распознать текст в скане, а потом сжать результат. Работает только для результатов в PDF (иначе 422), до завершения операции — 409, после удаления результата — 410. На бесплатном тарифе это не тратит единственную ссылку на скачивание. Каждая операция цепочки оплачивается отдельно.