Przejdź do głównej zawartości

Kredyty i użytkowanie

Usługi rozliczane są w postaci kredytów konta. Kwoty podawane są w milikredytach (millicredits); 1000 milikredytów odpowiada 1 kredytowi. Kwoty przesyłane w żądaniach muszą być liczbami całkowitymi; kwoty na saldach i w rekordach mogą zawierać jedną cyfrę po przecinku (0,1 milikredytu). credit_precision w odpowiedziach to 4, co oznacza maksymalnie 4 miejsca po przecinku po przeliczeniu na kredyty.

GET /api/v1/billing/credits/balance
Okno terminala
curl https://omnidoc.top/api/v1/billing/credits/balance \
-H "X-API-Key: $OMNIDOC_API_KEY"

Kluczowe pola:

PoleZnaczenie
availableMilicredyty dostępne teraz, po spłaceniu długu; ujemne w przypadku zadłużenia
debtDług w milicredytach: część rzeczywistego kosztu zakończonych zadań, która przekroczyła saldo. Kredyty otrzymywane później (doładowania, dotacje dzienne, kody rabatowe, zwroty itp.) są najpierw naliczane do spłaty długu.
spentŁączna liczba uregulowanych milicredytów
expiredMilicredyty, które straciły ważność lub zostały wycofane
today_chargedMillicredyty zostały rozliczone dzisiaj
lotsObowiązujące aktualnie partie kredytowe i ich daty ważności
GET /api/v1/billing/credits/plans

Publiczny punkt końcowy, który nie wymaga uwierzytelniania i zwraca pakiety na sprzedaż (purchase_plans, indeksowane według kodu planu). Teraz w sprzedaży:

Kod planuKredytyCenaBonus
credits_3000_v43,000¥9.90—
credits_10000_v410,000¥29.90—
credits_25000_v425,000¥698%
credits_50000_v4 (zalecane)50,000¥12916%
credits_125000_v4125,000¥29925%
credits_450000_v4450,000¥99935%
  • „Bonus” jest obliczany na podstawie ceny 10 000 kredytów w wysokości 29,90 ¥ i odpowiada polu bonus_percent; polecany pakiet ma wartość recommended: true. Żadne z tych pól nie jest wyświetlane, jeśli nie zostało ustawione.
  • price_fen (w fenach, 1/100 juana) stanowi podstawę ceny, a total_millicredits (milicredyty) — podstawę liczb kredytów. Kupione kredyty nie wygasają; pakiety można nabywać ponownie i za każdym razem otrzymuje się je w całości.
  1. Saldo jest sprawdzane pod kątem progu przed rozpoczęciem zadania : saldo (po odjęciu długu) musi przekraczać próg dla danego zadania, na przykład „strony × 2 kredyty” dla tłumaczenia PDF, długość tekstu źródłowego dla innych plików (co najmniej 2 kredyty), a w przypadku audio, wideo i mowy koszt obliczany jest na podstawie długości lub liczby znaków zmierzonej przez serwer (ceny w audio, wideo i głosy ). W przypadku klucza API z budżetem pozostały budżet klucza również musi przekraczać próg. W przeciwnym razie odpowiedź brzmi 402 (zadanie tłumaczenia pliku kończy się niepowodzeniem z quota_exceeded=true, zadanie związane z mediami kończy się z error_code=insufficient_credits) i żaden opłatę nie jest naliczana. Rozpoczęcie zadania nie zmienia salda.
  2. Rzeczywiste zużycie jest rozliczane po jego zakończeniu : tłumaczenie plików (w tym obrazów), grupowa obsługa tekstu w bogatym formacie, operacje na dokumentach, audio, wideo i mowa są rozliczane w pełnej wysokości za rzeczywiste zużycie po zakończeniu. Budżet klucza API bierze pod uwagę tylko sprawdzenie przed rozpoczęciem i nigdy nie zmniejsza opłaty za zakończoną pracę; jeśli w wyniku tego zużytый budżet klucza przekroczy limit, klucz nie będzie mógł rozpoczynać nowych zadań, dopóki limit nie zostanie podniesiony. Nieopłacone lub anulowane zadania nie są rozliczane.
  3. Saldo może być ujemne : część rzeczywistych kosztów przekraczająca saldo jest zapisywana jako dług, a saldo wyświetlane jest jako ujemne; wpływy kredytowe nadejdące później najpierw spłacają ten dług. Nowe zadania nie mogą zostać rozpoczęte, gdy saldo jest ujemne; należy je doładować.

Klienci nigdy nie wysyłają zapytania „ile powinno zostać naliczone”; serwer oblicza ostateczną kwotę na podstawie dostarczonego.

GET /api/v1/billing/credits/operations?limit=20
GET /api/v1/billing/credits/operations/{operation_id}
GET /api/v1/billing/credits/jobs/{job_id}

Zapis zawiera identyfikator operacji, status, podstawę rozliczeniową oraz naliczone i zwrócone kwoty. W przypadku klucza API są one ograniczone wyłącznie do operacji rozpoczętych przy użyciu tego klucza.

GET /api/v1/usage?limit=50
GET /api/v1/usage/summary

Endpunkty użytkownika zwracają liczbę plików konta, liczbę znaków, tokenów oraz czas przetwarzania.

Sprawdzanie salda, statusu zadania, zużycia, rekordów rozliczeń, list wyników i adresów pobierania nie kosztuje żadnych kredytów.