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.
Provjerite stanje
Section titled “Provjerite stanje”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 dostupni sada, nakon dugovanja; negativni kada ste u minusu |
debt | Dug 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. |
spent | Ukupno podmireni milikrediti |
expired | Milikrediti koji su istekli ili su povučeni |
today_charged | Milikrediti obračunati danas |
lots | Trenutno važeći kreditni lotovi i njihovo istjecanje roka |
Paketi kredita
Section titled “Paketi kredita”GET /api/v1/billing/credits/plansJavna točka pristupa koja ne zahtijeva prijavu i vraća pakete u prodaji (purchase_plans, indeksirane prema kodu plana). Sada u prodaji:
| Kod plana | Zasluge | Cijena | 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 temelju cijene od 10.000 kredita za 29,90 ¥ i predstavlja polje
bonus_percent; preporučeni paket imarecommended: true. Niti jedno od ovih polja ne prikazuje se ako nije postavljeno. price_fen(u fenovima, 1/100 yuana) je mjerodavno za cijenu, atotal_millicredits(milikrediti) za kredite. Kupljeni krediti ne istječu; pakete je moguće ponovno kupiti i svaki put stignu odjednom.
Životni ciklus punjenja
Section titled “Životni ciklus punjenja”- 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 squota_exceeded=true, zadatak medijskih sadržaja završava serror_code=insufficient_credits) i ništa se ne naplaćuje. Pokretanje zadatka ne mijenja saldo. - 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.
- 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.
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 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.
Upotreba
Section titled “Upotreba”GET /api/v1/usage?limit=50GET /api/v1/usage/summaryKrajnje točke za korištenje vraćaju broj datoteka, znakova, tokena i vrijeme obrade računa.
Upiti su besplatni
Section titled “Upiti su besplatni”Provjeravanje stanja, statusa zadatka, korištenja, evidencije podmirenja, popisa rezultata i adresa za preuzimanje ne oduzima kredite.