# SmartPDF API — документация

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

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

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

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

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

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

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

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

Подробно — [Как это работает](https://dev.smartpdf.ru/docs/how-it-works).

## Оплата

Каждый запрос оплачивается с баланса API аккаунта в рублях: 1,25 ₽ за файл до 10 МБ, у тяжёлых операций считаются ещё и страницы. Подписки нет, баланс не сгорает. После регистрации и подтверждения почты на баланс зачисляется 300 ₽. Подробно — [Оплата](https://dev.smartpdf.ru/docs/billing).

## Данные

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