跳转到内容

Krediti i potrošnja

Naplative usluge se obračunavaju u kreditima na računu. Iznosi su navedeni u milikreditima (millicredits); 1000 milikredita jednaki su 1 kreditu. Iznosi koje šaljete u zahtevima moraju biti celi brojevi; iznosi na bilansima i u evidencijama mogu imati jednu decimalu (0,1 milikredita). credit_precision u odgovorima je 4, što znači najviše 4 decimalna mesta nakon konverzije u kredite.

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

Ključna polja:

PoljeZnačenje
availableMilikrediti su sada dostupni, nakon duga; negativni su kada je u poziciji duga
debtDug u milikreditima: deo stvarne cene završenih zadataka koji je premašio saldo. Krediti koji stižu kasnije (dopune, dnevne subvencije, kodovi za otplatu, povraćaji i slično) najpre pokrivaju dug.
spentUkupno izmireno milikredita
expiredMilikrediti koji su istekli ili su povučeni
today_chargedMilikrediti su danas izmireni
lotsKreditni lotovi koji su trenutno važeći i njihovo isteka
GET /api/v1/billing/credits/plans

Javna tačka pristupa kojoj nije potrebno prijavljivanje i koja vraća pakete u prodaji (purchase_plans, indeksirane po kodu plana). Sada u prodaji:

Kod planaKreditiCenaBonus
credits_3000_v43,000¥9.90—
credits_10000_v410,000¥29.90—
credits_25000_v425,000¥698%
credits_50000_v4 (preporučeno)50,000¥12916%
credits_125000_v4125,000¥29925%
credits_450000_v4450,000¥99935%
  • „Bonus“ se izračunava na osnovu cene od 10.000 kredita za 29,90 ¥ i predstavlja polje bonus_percent; preporučeni paket ima recommended: true. Nijedno od ovih polja se ne prikazuje ako nije podešeno.
  • price_fen (u fenovima, 1/100 juana) je merodavan za cenu, a total_millicredits (milikrediti) za kredite. Kupljeni krediti ne ističu; pakete je moguće kupiti ponovo i svaki put stižu odjednom.
  1. Saldo se proverava u odnosu na prag pre početka zadatka : saldo (nakon duga) mora biti iznad praga zadatka, na primer „stranice × 2 kredita“ za prevod PDF, dužina izvornog teksta za druge datoteke (najmanje 2 kredita), a za audio, video i govor trošak se izračunava na osnovu trajanja ili karaktera koje je server izmerio (cene u audio, video i glasovi ). Uz API ključ koji ima budžet, preostali budžet ključa takođe mora biti iznad praga. U suprotnom, odgovor je 402 (zadatak prevoda datoteke završava se neuspešno sa quota_exceeded=true, zadatak medija završava se sa error_code=insufficient_credits) i ništa se ne naplaćuje. Započinjanje zadatka ne menja saldo.
  2. Stvarna potrošnja se naplaćuje po završetku : prevod fajlova (uključujući slike), grupni oblikovani tekst, operacije sa dokumentima, audio, video i govor se u potpunosti naplaćuju prema stvarnoj potrošnji po završetku. Budžet API ključa učestvuje samo u proveri pre početka i nikada ne umanjuje naplatu za završen posao; ako time budžet korišćenog ključa pređe svoj limit, ključ ne može da pokrene nove poslove dok se limit ne poveća. Neuspeli ili otkazani poslovi se ne naplaćuju.
  3. Saldo može postati negativan : deo stvarnih troškova koji premašuje saldo evidentira se kao dug, a saldo se prikazuje kao negativan; krediti koji stignu kasnije prvo otplaćuju taj dug. Novi poslovi ne mogu započeti dok je saldo negativan; dopunite ga.

Klijenti nikada ne dostavljaju „koliko treba naplatiti“; server izračunava ugovoreni iznos na osnovu isporučenog.

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 sadrži ID operacije, status, osnovu za obračun i iznose naplaćene i vraćene. Uz navođenje API ključa, operacije uključuju samo one koje su započete pomoću tog ključa.

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

Krajnje tačke upotrebe vraćaju broj datoteka, karaktere, tokene i vreme obrade naloga.

Provera bilansa, statusa zadatka, potrošnje, zapisa o obračunu, lista rezultata i adrese za preuzimanje ne koštaju kredite.