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.
Sprawdź saldo
Dział zatytułowany „Sprawdź saldo”GET /api/v1/billing/credits/balancecurl https://omnidoc.top/api/v1/billing/credits/balance \ -H "X-API-Key: $OMNIDOC_API_KEY"Kluczowe pola:
| Pole | Znaczenie |
|---|---|
available | Milicredyty dostępne teraz, po spłaceniu długu; ujemne w przypadku zadłużenia |
debt | Dł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 |
expired | Milicredyty, które straciły ważność lub zostały wycofane |
today_charged | Millicredyty zostały rozliczone dzisiaj |
lots | Obowiązujące aktualnie partie kredytowe i ich daty ważności |
Pakiety kredytów
Dział zatytułowany „Pakiety kredytów”GET /api/v1/billing/credits/plansPubliczny 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 planu | Kredyty | Cena | Bonus |
|---|---|---|---|
credits_3000_v4 | 3,000 | ¥9.90 | — |
credits_10000_v4 | 10,000 | ¥29.90 | — |
credits_25000_v4 | 25,000 | ¥69 | 8% |
credits_50000_v4 (zalecane) | 50,000 | ¥129 | 16% |
credits_125000_v4 | 125,000 | ¥299 | 25% |
credits_450000_v4 | 450,000 | ¥999 | 35% |
- „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, atotal_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.
Cykl ładowania
Dział zatytułowany „Cykl ładowania”- 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 zquota_exceeded=true, zadanie związane z mediami kończy się zerror_code=insufficient_credits) i żaden opłatę nie jest naliczana. Rozpoczęcie zadania nie zmienia salda. - 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.
- 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.
Operacje i zapisy
Dział zatytułowany „Operacje i zapisy”GET /api/v1/billing/credits/operations?limit=20GET /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=50GET /api/v1/usage/summaryEndpunkty użytkownika zwracają liczbę plików konta, liczbę znaków, tokenów oraz czas przetwarzania.
Zapytania są bezpłatne
Dział zatytułowany „Zapytania są bezpłatne”Sprawdzanie salda, statusu zadania, zużycia, rekordów rozliczeń, list wyników i adresów pobierania nie kosztuje żadnych kredytów.