Лимиты и ошибки
Ваш тариф
Каждый документ, который читает Ocost, один раз засчитывается в месяц вашей компании. Повторно отправленные байты и поиски не засчитываются. Настройки › Тариф и оплата показывают месяц на текущий момент. Каждый ответ на 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 написан по-английски для ваших журналов и может меняться.
{
"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 | 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 работает в ЕС. Оригиналы, прочитанное и поисковый индекс хранятся, пока вы не удалите файл или пока не будет удалена ваша компания. Документы никогда не обучают модель.