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.
Proverite bilans
Section titled “Proverite bilans”GET /api/v1/billing/credits/balancecurl https://omnidoc.top/api/v1/billing/credits/balance \ -H "X-API-Key: $OMNIDOC_API_KEY"Ključna polja:
| Polje | Značenje |
|---|---|
available | Milikrediti su sada dostupni, nakon duga; negativni su kada je u poziciji duga |
debt | Dug 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. |
spent | Ukupno izmireno milikredita |
expired | Milikrediti koji su istekli ili su povučeni |
today_charged | Milikrediti su danas izmireni |
lots | Kreditni lotovi koji su trenutno važeći i njihovo isteka |
Paketi kredita
Section titled “Paketi kredita”GET /api/v1/billing/credits/plansJavna tačka pristupa kojoj nije potrebno prijavljivanje i koja vraća pakete u prodaji (purchase_plans, indeksirane po kodu plana). Sada u prodaji:
| Kod plana | Krediti | 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 (preporučeno) | 50,000 | ¥129 | 16% |
credits_125000_v4 | 125,000 | ¥299 | 25% |
credits_450000_v4 | 450,000 | ¥999 | 35% |
- „Bonus“ se izračunava na osnovu cene od 10.000 kredita za 29,90 ¥ i predstavlja polje
bonus_percent; preporučeni paket imarecommended: true. Nijedno od ovih polja se ne prikazuje ako nije podešeno. price_fen(u fenovima, 1/100 juana) je merodavan za cenu, atotal_millicredits(milikrediti) za kredite. Kupljeni krediti ne ističu; pakete je moguće kupiti ponovo i svaki put stižu odjednom.
Životni ciklus punjenja
Section titled “Životni ciklus punjenja”- 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 saquota_exceeded=true, zadatak medija završava se saerror_code=insufficient_credits) i ništa se ne naplaćuje. Započinjanje zadatka ne menja saldo. - 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.
- 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.
Operacije i zapisi
Section titled “Operacije i zapisi”GET /api/v1/billing/credits/operations?limit=20GET /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.
Upotreba
Section titled “Upotreba”GET /api/v1/usage?limit=50GET /api/v1/usage/summaryKrajnje tačke upotrebe vraćaju broj datoteka, karaktere, tokene i vreme obrade naloga.
Zapiti su besplatni
Section titled “Zapiti su besplatni”Provera bilansa, statusa zadatka, potrošnje, zapisa o obračunu, lista rezultata i adrese za preuzimanje ne koštaju kredite.