Limity i błędy
Twój plan
Każdy dokument odczytany przez Ocost liczy się raz do miesiąca Twojej firmy. Ponownie wysłane bajty i wyszukiwania nie liczą się wcale. Ustawienia › Plan i rozliczenia pokazuje dotychczasowy miesiąc. Każda odpowiedź na POST /public/v1/files podaje w X-Ocost-Documents-Left, ile zostało.
Po osiągnięciu limitu Ocost nadal zapisuje plik. Odpowiada not_read z reason: "limit" i renews_on. Ocost sam odczyta plik, gdy miesiąc się odnowi lub plan się powiększy.
Limity wywołań
Każdy klucz ma limit na minutę dla każdego uprawnienia:
| Uprawnienie | Wywołań na minutę |
|---|---|
documents:write | 120 |
documents:read | 600 |
search:read | 60 |
figures:read | 120 |
exports:write | 10 |
Po przekroczeniu limitu Ocost odpowiada 429 urn:ocost:key:rate z Retry-After w sekundach. Z jednego adresu 30 błędnych kluczy na minutę dostaje 401, a kolejne dostają 429.
Wszystkie klucze z jednego adresu dzielą zewnętrzny limit: 50 żądań na sekundę, chwilowo do 200, i 100 otwartych naraz. Po jego przekroczeniu wraca 429 jako zwykły tekst z Retry-After. Wysyłaj naraz tylko kilka żądań i rozkładaj partię na całą minutę.
Rozmiary
| Co | Limit |
|---|---|
| Plik | 25 MB, odrzucany przed odczytem z 413 urn:ocost:file:too_large |
| Długi PDF | Odczytywane są tylko jego pierwsze strony. pages_read mówi, ile. |
| Wyszukiwanie | q do 200 znaków, limit do 50, offset do 250 |
| Żądanie MCP | 4 MB. Klucze z documents:write mogą wysłać plik w base64. Powyżej 413. |
Błędy
Błędy to problemy RFC 9457 z Content-Type: application/problem+json. Rozgałęziaj logikę według status i type. detail jest po angielsku, do Twoich logów, i może się zmienić.
{
"type": "urn:ocost:key:scope",
"title": "Forbidden",
"status": 403,
"detail": "This key lacks the scope documents:write.",
"instance": "/public/v1/files"
}| Typ | Status | Znaczenie |
|---|---|---|
urn:ocost:key:invalid | 401 | Brak klucza albo klucz błędny, unieważniony lub wygasły. |
urn:ocost:key:scope | 403 | Klucz nie ma tego uprawnienia. |
urn:ocost:key:rate | 429 | Za dużo wywołań. Poczekaj Retry-After. |
urn:ocost:file:too_large | 413 | Plik przekracza 25 MB. |
urn:ocost:file:format | 415 | Format, którego Ocost nie odczytuje. |
urn:ocost:file:reading | 409 | Plik jest właśnie odczytywany. Usuń go później. |
urn:ocost:file:kept | 409 | Te same bajty są przechowywane tam, gdzie klucze ich nie widzą, na przykład jako własny plik jakiejś osoby. Nic się nie zmienia. |
urn:ocost:file:linked | 409 | Ocost wciąż potrzebuje pliku. Usuń go w Ocost, gdy nic go już nie potrzebuje. |
about:blank | 404 | Nie ma takiego pliku ani dokumentu albo należy do innej firmy. |
about:blank | 422 | Nieprawidłowe pola, każde w errors[] ze swoim loc. |
about:blank | 503 | Spróbuj ponownie za chwilę. |
Plik wysłany bez nagłówka Content-Length dostaje 411.
Ponawianie
| Odpowiedź | Co zrobić |
|---|---|
429, 5xx | Poczekaj Retry-After albo rób przerwy 1, 2, 4 sekundy i tak dalej, najwyżej minutę. |
401 | Przerwij i powiadom człowieka. Klucz trzeba wymienić. |
Każde inne 4xx | Nie wysyłaj ponownie tego samego żądania. |
Ponowne wysłanie pliku jest bezpieczne, bo te same bajty to ten sam plik. Ponowne usunięcie też jest bezpieczne i daje 404.
Twoje dane
Ocost działa w UE. Oryginały, odczyty i indeks wyszukiwania zostają, dopóki nie usuniesz pliku lub Twoja firma nie zostanie usunięta. Dokumenty nigdy nie trenują żadnego modelu.