Preskočiť na obsah

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.

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

Kľúčové polia:

PolíčkoVýznam
availableMillicredity sú dostupné teraz, po splatení dlhu; pri dlhu majú zápornú hodnotu.
debtDlž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.
spentCelkový vyrovnaný počet millicreditov
expiredMillicredity, ktoré vypršali alebo boli stiahnuté
today_chargedMillicredity boli dnes vyrovnané
lotsKreditné loty aktuálne platné a ich dátum vypršania platnosti
GET /api/v1/billing/credits/plans

Verejný 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ánuKredityCenaBonus
credits_3000_v43,000¥9.90—
credits_10000_v410,000¥29.90—
credits_25000_v425,000¥698%
credits_50000_v4 (odporúčané)50,000¥12916%
credits_125000_v4125,000¥29925%
credits_450000_v4450,000¥99935%
  • „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á hodnotu recommended: 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 a total_millicredits (milicredity) pre kredity. Zakúpené kredity nevyprchajú; balíčky možno kúpiť opakovane a vždy prídu naraz.
  1. 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á s quota_exceeded=true, mediálna úloha končí s error_code=insufficient_credits) a nič sa neúčtuje. Spustenie úlohy nemenná zostatok.
  2. 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ú.
  3. 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.

GET /api/v1/billing/credits/operations?limit=20
GET /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.

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

Koncové body používania vracajú počet súborov účtu, znaky, tokeny a čas spracovania.

Kontrola zostatku, stavu úloh, využitia, záznamov o vypočítaní, zoznamov výsledkov a adries na stiahnutie nestojí žiadne kredity.