# Загрузка файлов

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

`POST /v1/upload` — файл в `multipart/form-data`, поле `file`.

```bash
curl https://api.smartpdf.ru/v1/upload -H "X-API-Key: $SMARTPDF_API_KEY" -F "file=@document.pdf"
```

Ответ `201`:

```json
{
  "file_id": "6b0e3c4d9f2a4e1b8c7d5a3f2e1d0c9b",
  "filename": "document.pdf",
  "size": 48213
}
```

## Форматы

PDF; Word — DOC и DOCX; Excel — XLS и XLSX; PowerPoint — PPT и PPTX; изображения — JPG, PNG, WEBP, GIF; HTML. Какой формат нужен операции — на её странице в разделе [Операции](https://dev.smartpdf.ru/docs/operations).

Тип файла берётся из `Content-Type` части, а если клиент прислал общий тип вроде `application/octet-stream` или никакого — из расширения имени файла. Содержимое сверяется с типом по сигнатуре: переименованный или повреждённый файл получит `415`.

## Размер

Максимальный размер — по тарифу аккаунта: 50 МБ, на Про — 200 МБ, на Бизнесе — 500 МБ. Файл больше — `413`.

## Срок жизни

`file_id` действует час: потом файл удаляется, и операции с этим `file_id` получат `404`. В течение часа один `file_id` можно использовать в нескольких операциях — например, сначала распознать текст, потом сжать.

## Страницы

У PDF при загрузке считаются страницы — по ним считается цена тяжёлых операций (см. [Оплата](https://dev.smartpdf.ru/docs/billing)) и проверяется лимит распознавания текста.