跳转到内容

Krediti i potrošnja

Fakturirane usluge obračunavaju se u kreditima računa. Iznosi su izraženi u milikreditima (millicredits); 1000 milikredita jednako je 1 kreditu. Iznosi koje šaljete u zahtjevima moraju biti cijeli brojevi; iznosi na stanjima i u evidenciji mogu imati jednu decimalu (0,1 milikredita). credit_precision u odgovorima iznosi 4, što znači najviše 4 decimale nakon pretvorbe 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 dostupni sada, nakon dugovanja; negativni kada ste u minusu
debtDug u milikreditima: dio stvarnih troškova završenih poslova koji je premašio stanje. Krediti koji pristignu kasnije (dopune, dnevne subvencije, kodovi za unovčavanje, povrati novca i slično) prvo se isplate ovaj dug.
spentUkupno podmireni milikrediti
expiredMilikrediti koji su istekli ili su povučeni
today_chargedMilikrediti obračunati danas
lotsTrenutno važeći kreditni lotovi i njihovo istjecanje roka
GET /api/v1/billing/credits/plans

Javna točka pristupa koja ne zahtijeva prijavu i vraća pakete u prodaji (purchase_plans, indeksirane prema kodu plana). Sada u prodaji:

Kod planaZaslugeCijenaBonus
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 temelju cijene od 10.000 kredita za 29,90 ¥ i predstavlja polje bonus_percent; preporučeni paket ima recommended: true. Niti jedno od ovih polja ne prikazuje se ako nije postavljeno.
  • price_fen (u fenovima, 1/100 yuana) je mjerodavno za cijenu, a total_millicredits (milikrediti) za kredite. Kupljeni krediti ne istječu; pakete je moguće ponovno kupiti i svaki put stignu odjednom.
  1. Saldo se provjerava u odnosu na prag prije početka zadatka : saldo (nakon dugovanja) mora biti iznad praga zadatka, primjerice „stranice × 2 kredita” za prevod PDF, duljina izvornog teksta za druge datoteke (najmanje 2 kredita), a za audio, video i govorne sadržaje trošak se izračunava na temelju trajanja ili znakova koje je server izmjerio (cijene u audio, video i glasovi ). Uz API ključ koji ima budžet, preostali budžet ključa također mora biti iznad praga. U suprotnom, odgovor je 402 (zadatak prevoda datoteke završava neuspješno s quota_exceeded=true, zadatak medijskih sadržaja završava s error_code=insufficient_credits) i ništa se ne naplaćuje. Pokretanje zadatka ne mijenja saldo.
  2. Stvarna potrošnja se naplaćuje po završetku : prevod datoteka (uključujući slike), grupirani obogaćeni tekst, operacije s dokumentima, audio, video i govor naplaćuju se u cijelosti prema stvarnoj potrošnji po završetku. Budžet API ključa sudjeluje samo u provjeri prije početka i nikada ne umanjuje naplatu za završen posao; ako time budžet korištenog ključa prijeđe svoj limit, ključ ne može pokrenuti nove poslove dok se limit ne poveća. Neuspjeli ili otkazani poslovi se ne naplaćuju.
  3. Saldo može postati negativan : dio stvarnih troškova koji premašuje saldo evidentira se kao dug, a saldo se prikazuje kao negativan; krediti koji pristignu kasnije prvo otplaćuju taj dug. Novi poslovi ne mogu započeti dok je saldo negativan; dopunite ga.

Klijenti nikada ne dostavljaju “koliko bi trebalo naplatiti”; poslužitelj izračunava konačni iznos na temelju 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 naplatu te iznose koji su naplaćeni i refundirani. Uz navedeni API ključ, operacije uključuju samo one koje su započete tim ključem.

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

Krajnje točke za korištenje vraćaju broj datoteka, znakova, tokena i vrijeme obrade računa.

Provjeravanje stanja, statusa zadatka, korištenja, evidencije podmirenja, popisa rezultata i adresa za preuzimanje ne oduzima kredite.