# Лимиты и ошибки
> Документы тарифа в месяц, лимиты частоты, размеры, ошибки RFC 9457, повторы и где хранятся данные.

## Ваш тариф

Каждый документ, который читает Ocost, один раз засчитывается в месяц вашей компании. Повторно отправленные байты и поиски не засчитываются. [Настройки › Тариф и оплата](https://app.ocost.io/settings/plan) показывают месяц на текущий момент. Каждый ответ на `POST /public/v1/files` сообщает остаток в `X-Ocost-Documents-Left`.

На лимите Ocost всё равно сохраняет файл. Он отвечает `not_read` с `reason: "limit"` и `renews_on`. Ocost сам прочитает файл, когда начнётся новый месяц или тариф станет больше.

## Лимиты частоты

У каждого ключа есть лимит в минуту для каждого права:

| Право | Вызовов в минуту |
| --- | --- |
| `documents:write` | 120 |
| `documents:read` | 600 |
| `search:read` | 60 |
| `figures:read` | 120 |
| `exports:write` | 10 |

Сверх лимита Ocost отвечает `429 urn:ocost:key:rate` с `Retry-After` в секундах. С одного адреса 30 неверных ключей в минуту получают `401`, а сверх того — `429`.

Все ключи с одного адреса делят общий внешний лимит: 50 запросов в секунду, всплески до 200 и 100 открытых запросов одновременно. Сверх него приходит `429` простым текстом с `Retry-After`. Держите одновременно лишь несколько запросов и распределяйте пакет по его минуте.

## Размеры

| Что | Лимит |
| --- | --- |
| Файл | 25 МБ, отклоняется до чтения с `413 urn:ocost:file:too_large` |
| Длинный PDF | Читаются только первые страницы. `pages_read` говорит, сколько. |
| Поиск | `q` до 200 символов, `limit` до 50, `offset` до 250 |
| Запрос MCP | 4 МБ. Ключи с `documents:write` могут отправить файл в base64. Сверх лимита — `413`. |

## Ошибки

Ошибки — это проблемы RFC 9457 с `Content-Type: application/problem+json`. Стройте логику на `status` и `type`. `detail` написан по-английски для ваших журналов и может меняться.

```json
{
  "type": "urn:ocost:key:scope",
  "title": "Forbidden",
  "status": 403,
  "detail": "This key lacks the scope documents:write.",
  "instance": "/public/v1/files"
}
```

| Тип | Статус | Смысл |
| --- | --- | --- |
| `urn:ocost:key:invalid` | 401 | Ключа нет, или он неверен, отозван или истёк. |
| [`urn:ocost:key:scope`](https://ocost.io/docs/ru/authentication.md) | 403 | У ключа нет нужного права. |
| `urn:ocost:key:rate` | 429 | Слишком много вызовов. Подождите `Retry-After`. |
| `urn:ocost:file:too_large` | 413 | Файл больше 25 МБ. |
| `urn:ocost:file:format` | 415 | Формат, который Ocost не читает. |
| `urn:ocost:file:reading` | 409 | Файл сейчас читается. Удалите его позже. |
| `urn:ocost:file:kept` | 409 | Те же байты хранятся там, где ключи их не видят, например в личной загрузке человека. Ничего не меняется. |
| `urn:ocost:file:linked` | 409 | Файл ещё нужен Ocost. Удалите его в Ocost, когда он больше ничему не нужен. |
| `about:blank` | 404 | Такого файла или документа нет, или он принадлежит другой компании. |
| `about:blank` | 422 | Неверные поля, каждое в `errors[]` со своим `loc`. |
| `about:blank` | 503 | Повторите чуть позже. |

Файл, отправленный без заголовка `Content-Length`, получает `411`.

## Повторы

| Ответ | Что делать |
| --- | --- |
| `429`, `5xx` | Подождите `Retry-After` или делайте паузы в 1, 2, 4 секунды и так далее, не дольше минуты. |
| `401` | Остановитесь и сообщите человеку. Ключ нужно заменить. |
| Любой другой `4xx` | Не отправляйте тот же запрос снова. |

Повторно отправлять файл безопасно, потому что те же байты — это тот же файл. Повторное удаление тоже безопасно и отвечает `404`.

## Ваши данные

Ocost работает в ЕС. Оригиналы, прочитанное и поисковый индекс хранятся, пока вы не удалите файл или пока не будет удалена ваша компания. Документы никогда не обучают модель.

## См. также

- [Ключи и права](https://ocost.io/docs/ru/authentication.md): Ключи API: как запрос передаёт ключ, смена ключей, их права и отказы.
- [Статусы и причины](https://ocost.io/docs/ru/statuses.md): Статусы файла и причины, по которым он не прочитан, и что делать в каждом случае.
- [Отправить файл и прочитать](https://ocost.io/docs/ru/files.md): Отправить файл, безопасно отправить его повторно, дождаться чтения, прочитать его документы, получить оригинал, удалить его.
- На ocost.io: [Pricing](https://ocost.io/en/pricing), [Data sovereignty](https://ocost.io/en/data-sovereignty)
