Kredity a použitie
Fakturovateľné služby sa účtujú v kreditoch účtu. Sumy sú uvádzané v milikreditech (millicredits); 1000 milikreditov sa rovná 1 kreditu. Sumy, ktoré odosielate v požiadavkách, musia byť celé čísla; sumy v zostatkoch a záznamoch môžu mať jednu desatinnú čiarku (0,1 milikreditu). credit_precision v odpovediach je 4, čo znamená najviac 4 desatinné miesta po prepočte na kredity.
Skontrolujte zostatok
Section titled “Skontrolujte zostatok”GET /api/v1/billing/credits/balancecurl https://omnidoc.top/api/v1/billing/credits/balance \ -H "X-API-Key: $OMNIDOC_API_KEY"Kľúčové polia:
| Políčko | Význam |
|---|---|
available | Millicredity sú dostupné teraz, po splatení dlhu; pri dlhu majú zápornú hodnotu. |
debt | Dlžná suma v millicreditoch: časť skutočných nákladov na dokončené úlohy, ktorá prevýšila zostatok. Kredity, ktoré prídu neskôr (doplnenia, denné granty, kódy na uplatnenie, vrátenia peňazí a pod.), najprv použité na splatenie dlhu. |
spent | Celkový vyrovnaný počet millicreditov |
expired | Millicredity, ktoré vypršali alebo boli stiahnuté |
today_charged | Millicredity boli dnes vyrovnané |
lots | Kreditné loty aktuálne platné a ich dátum vypršania platnosti |
Kreditové balíčky
Section titled “Kreditové balíčky”GET /api/v1/billing/credits/plansVerejný koncový bod, ktorý nevyžaduje prihlásenie a vráti balíčky v predaji (purchase_plans, indexované podľa kódu plánu). Teraz v predaji:
| Kód plánu | Kredity | 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 (odporúčané) | 50,000 | ¥129 | 16% |
credits_125000_v4 | 125,000 | ¥299 | 25% |
credits_450000_v4 | 450,000 | ¥999 | 35% |
- „Bonus“ sa vypočítava na základe ceny 10 000 kreditov za 29,90 ¥ a je to pole
bonus_percent; odporúčaný balík má hodnoturecommended: true. Žiadne z týchto polí sa nezobrazí, ak nie sú nastavené. price_fen(v fenoch, 1/100 jüanu) je autoritatívna hodnota pre cenu atotal_millicredits(milicredity) pre kredity. Zakúpené kredity nevyprchajú; balíčky možno kúpiť opakovane a vždy prídu naraz.
Životný cyklus nabíjania
Section titled “Životný cyklus nabíjania”- Zostatok sa skontroluje voči prahu pred spustením úlohy : zostatok (po odpočítaní dlhu) musí byť nad prahom úlohy, napríklad „počet strán × 2 kreditov“ pre preklad PDF, dĺžka zdrojového textu pre iné súbory (aspoň 2 kredity) a pre audio, video a reč náklady vypočítané z dĺžky alebo znakov, ktoré server nameral (ceny v audio, video a hlasy ). Pri API kľúči s rozpočtom musí aj zostávajúci rozpočet kľúča byť nad prahom. V opačnom prípade je odpoveď
402(úloha prekladu súboru končí ako neúspešná squota_exceeded=true, mediálna úloha končí serror_code=insufficient_credits) a nič sa neúčtuje. Spustenie úlohy nemenná zostatok. - Skutočné využitie sa účtuje po jeho dokončení : preklad súborov (vrátane obrázkov), dávkový formátovaný text, operácie s dokumentmi, audio, video a reč sa účtujú v plnej miere podľa skutočného využitia po dokončení. Rozpočet API kľúča sa zohľadňuje iba pri kontrole pred spustením a nikdy nezníži poplatok za dokončenú úlohu; ak by tým prekročil limit použitého rozpočtu kľúča, kľúč nemôže spustiť nové úlohy, kým sa limit nezvýši. Neúspešne ukončené alebo zrušené úlohy sa neúčtujú.
- Zostatok môže klesnúť do záporných hodnôt : časť skutočných nákladov, ktorá presahuje zostatok, sa eviduje ako dlh a zostatok sa zobrazuje ako záporný; kreditné príjmy, ktoré prídu neskôr, najskôr splácajú tento dlh. Nové práce nemôžu začať, pokiaľ je zostatok záporný; doplňte.
Klienti nikdy nezadávajú „koľko by sa malo účtovať“; server vypočíta konečnú sumu na základe dodaného.
Operácie a záznamy
Section titled “Operácie a záznamy”GET /api/v1/billing/credits/operations?limit=20GET /api/v1/billing/credits/operations/{operation_id}GET /api/v1/billing/credits/jobs/{job_id}Záznam obsahuje ID operácie, stav, základ na fakturáciu a účtované a vrátené sumy. Ak je uvedený API kľúč, zobrazia sa iba tie operácie, ktoré boli spustené týmto kľúčom.
Použitie
Section titled “Použitie”GET /api/v1/usage?limit=50GET /api/v1/usage/summaryKoncové body používania vracajú počet súborov účtu, znaky, tokeny a čas spracovania.
Dotazy sú bezplatné
Section titled “Dotazy sú bezplatné”Kontrola zostatku, stavu úloh, využitia, záznamov o vypočítaní, zoznamov výsledkov a adries na stiahnutie nestojí žiadne kredity.