Лимиты и ошибки

Ваш тариф

Каждый документ, который читает Ocost, один раз засчитывается в месяц вашей компании. Повторно отправленные байты и поиски не засчитываются. Настройки › Тариф и оплата показывают месяц на текущий момент. Каждый ответ на POST /public/v1/files сообщает остаток в X-Ocost-Documents-Left.

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

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

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

ПравоВызовов в минуту
documents:write120
documents:read600
search:read60
figures:read120
exports:write10

Сверх лимита 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
Запрос MCP4 МБ. Ключи с 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:invalid401Ключа нет, или он неверен, отозван или истёк.
urn:ocost:key:scope403У ключа нет нужного права.
urn:ocost:key:rate429Слишком много вызовов. Подождите Retry-After.
urn:ocost:file:too_large413Файл больше 25 МБ.
urn:ocost:file:format415Формат, который Ocost не читает.
urn:ocost:file:reading409Файл сейчас читается. Удалите его позже.
urn:ocost:file:kept409Те же байты хранятся там, где ключи их не видят, например в личной загрузке человека. Ничего не меняется.
urn:ocost:file:linked409Файл ещё нужен Ocost. Удалите его в Ocost, когда он больше ничему не нужен.
about:blank404Такого файла или документа нет, или он принадлежит другой компании.
about:blank422Неверные поля, каждое в errors[] со своим loc.
about:blank503Повторите чуть позже.

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

Повторы

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

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

Ваши данные

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

См. также