Введение

SmartPDF API — 24 операции с PDF по HTTP: конвертация в PDF и из PDF, сжатие, объединение и разделение, распознавание текста (OCR), работа со страницами, подпись, водяной знак и пароль. Те же инструменты, что на smartpdf.ru, — для вашего кода и ИИ-агентов.

#Как подключить

• REST API — базовый адрес https://api.smartpdf.ru/v1, ключ — в заголовке X-API-Key. Начните с быстрого старта.
• MCP-сервер — https://mcp.smartpdf.ru/mcp для Claude Code, Claude Desktop, Cursor, VS Code, Codex CLI, Gemini CLI и других агентов: MCP-сервер.
• Без кода — сценарии в n8n и Make.

Ключи API и MCP — одни и те же, баланс — общий.

#Как устроена работа

Все операции асинхронные — четыре запроса:

1. POST /v1/upload — загрузить файл и получить file_id.
2. POST /v1/pdf/<операция> — запустить операцию и получить task_id.
3. GET /v1/tasks/{task_id} — дождаться статуса done или получить вебхук.
4. GET /v1/tasks/{task_id}/download — получить ссылку на результат и скачать его.

Подробно — Как это работает.

#Оплата

Каждый запрос оплачивается с баланса API аккаунта в рублях: 1,25 ₽ за файл до 10 МБ, у тяжёлых операций считаются ещё и страницы. Подписки нет, баланс не сгорает. После регистрации и подтверждения почты на баланс зачисляется 300 ₽. Подробно — Оплата.

#Данные

Серверы и резервные копии — в Москве. Загруженные файлы удаляются через час, результаты — по сроку хранения тарифа аккаунта. У результатов через API и MCP нет водяного знака.