Ліміти та помилки
Ваш тариф
Кожен документ, який читає 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. |
Помилки
Помилки — це problems за 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 працює в ЄС. Оригінали, прочитане і пошуковий індекс зберігаються, доки ви не видалите файл або доки не буде видалено вашу компанію. Документи ніколи не навчають модель.