Операции
Каждая операция — 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 МБ суммы файлов |
| Фото в PDF | POST /v1/pdf/photo-to-pdf | photo_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 МБ |
| DjVu в PDF | POST /v1/pdf/djvu-to-pdf | djvu_to_pdf | 10 МБ |
| FB2 в PDF | POST /v1/pdf/fb2-to-pdf | fb2_to_pdf | 10 МБ |
| EPUB в PDF | POST /v1/pdf/epub-to-pdf | epub_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 в PNG | POST /v1/pdf/to-png | pdf_to_png | 10 МБ |
| 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 в Markdown | POST /v1/pdf/to-markdown | pdf_to_markdown | 10 МБ или 50 стр. |
| PDF в текст | POST /v1/pdf/to-txt | pdf_to_txt | 10 МБ |
| Изображения | |||
| Сжать фото | POST /v1/pdf/compress-image | compress_image | 10 МБ суммы файлов |
| HEIC в JPG | POST /v1/pdf/heic-to-jpg | heic_to_jpg | 10 МБ суммы файлов |
| Фото в текст | POST /v1/pdf/image-to-text | image_to_text | 10 МБ суммы файлов или 10 фото |
| PNG в JPG | POST /v1/pdf/png-to-jpg | png_to_jpg | 10 МБ суммы файлов |
| JPG в PNG | POST /v1/pdf/jpg-to-png | jpg_to_png | 10 МБ суммы файлов |
| WEBP в JPG | POST /v1/pdf/webp-to-jpg | webp_to_jpg | 10 МБ суммы файлов |
| Изменить размер фото | POST /v1/pdf/resize-image | resize_image | 10 МБ суммы файлов |
| Обрезать фото | POST /v1/pdf/crop-image | crop_image | 10 МБ |
| Повернуть фото | POST /v1/pdf/rotate-image | rotate_image | 10 МБ суммы файлов |
| Word в JPG | POST /v1/pdf/word-to-jpg | word_to_jpg | 10 МБ |
| Управление | |||
| Редактор PDF | POST /v1/pdf/edit | edit_pdf | 10 МБ |
| Сжать PDF | POST /v1/pdf/compress | compress_pdf | 10 МБ |
| PDF в ч/б | POST /v1/pdf/grayscale | grayscale_pdf | 10 МБ |
| PDF в PDF/A | POST /v1/pdf/to-pdfa | pdf_to_pdfa | 10 МБ |
| Восстановить PDF | POST /v1/pdf/repair | repair_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 МБ |
| Обрезать PDF | POST /v1/pdf/crop | crop_pdf | 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/redact | redact_pdf | 10 МБ |
| Найти персональные данные | POST /v1/pdf/find-personal-data | find_personal_data | 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. На бесплатном тарифе это не тратит единственную ссылку на скачивание. Каждая операция цепочки оплачивается отдельно.