# Ліміти та помилки
> Документи тарифу на місяць, обмеження частоти, розміри, помилки за 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`. |

## Помилки

Помилки — це problems за 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/uk/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/uk/authentication.md): Ключі API: як запит їх передає, заміна ключів, їхні дозволи і відмови.
- [Статуси та причини](https://ocost.io/docs/uk/statuses.md): Статуси файлу і причини, з яких його не прочитано, і що робити в кожному випадку.
- [Надіслати файл і прочитати](https://ocost.io/docs/uk/files.md): Надіслати файл, безпечно надіслати його знову, дочекатися прочитання, прочитати його документи, отримати оригінал, видалити його.
- На ocost.io: [Pricing](https://ocost.io/en/pricing), [Data sovereignty](https://ocost.io/en/data-sovereignty)
