Sari la conținut

Credite și utilizare

Serviciile facturabile se calculează în creditul de cont. Sumele sunt exprimate în milicredite (millicredits); 1000 milicredite echivalează cu 1 credit. Sumele trimise în cereri trebuie să fie numere întregi; sumele din solduri și înregistrări pot avea o cifră zecimală (0,1 milicredit). Valoarea credit_precision din răspunsuri este 4, ceea ce înseamnă cel mult 4 zecimale după conversia în credite.

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

Câmpuri cheie:

CâmpSemnificație
availableMilicredite disponibile acum, după datorie; negative în cazul datoriilor
debtDatorie în milicredite: partea din costul efectiv al sarcinilor finalizate care a depășit soldul. Creditele primite ulterior (adăugări de fonduri, granturi zilnice, coduri de redemnare, rambursări etc.) acoperă mai întâi datoria.
spentTotal milicredite achitate
expiredMilicredite care au expirat sau au fost retrase
today_chargedMillicreditele au fost compensate astăzi
lotsLoturile de credit valabile în prezent și termenul lor de expirare
GET /api/v1/billing/credits/plans

Un terminal public care nu necesită autentificare și returnează pachetele disponibile la vânzare (purchase_plans, indexate după codul plan). Disponibile acum:

Codul planuluiCreditePrețBonus
credits_3000_v43,000¥9.90—
credits_10000_v410,000¥29.90—
credits_25000_v425,000¥698%
credits_50000_v4 (recomandat)50,000¥12916%
credits_125000_v4125,000¥29925%
credits_450000_v4450,000¥99935%
  • „Bonusul” se calculează pe baza prețului de 10.000 de credite, egal cu 29,90 ¥, și este câmpul bonus_percent; pachetul recomandat are valoarea recommended: true. Niciunul dintre aceste câmpuri nu apare dacă nu este setat.
  • price_fen (în fen, 1/100 de yuan) este valabil pentru preț, iar total_millicredits (milicredite) pentru credite. Creditele achiziționate nu expiră; pachetele pot fi cumpărate din nou și sosesc într-o singură tranșă de fiecare dată.
  1. Saldoul este verificat față de un prag înainte de începerea unei sarcini : saldul (după datorii) trebuie să fie mai mare decât pragul specificat pentru sarcină, de exemplu „pagini × 2 credite” pentru traducerea PDF, lungimea textului sursă pentru alte fișiere (cel puțin 2 credite), iar pentru audio, video și speech costul se calculează pe baza duratei sau a caracterelor măsurate de server (prețurile sunt exprimate în audio, video și voci ). Dacă se folosește o cheie API cu un buget limitat, bugetul rămas al cheii trebuie, de asemenea, să depășească pragul. În caz contrar, răspunsul este 402 (o sarcină de traducere a unui fișier se încheie cu eșec quota_exceeded=true, o sarcină media se încheie cu error_code=insufficient_credits) și nu se facturează nimic. Inițierea unei sarcini nu modifică saldul.
  2. Utilizarea efectivă este facturată la finalizare : traducerea fișierelor (inclusiv imagini), text formattat în lot, operații cu documente, audio, video și speech sunt facturate integral în funcție de utilizarea efectivă la finalizare. Bugetul unei chei API participă doar la verificarea dinainte de începere și nu reduce niciodată costul pentru o sarcină finalizată; dacă acest lucru determină depășirea limitii bugetului folosit al cheii, aceasta nu poate iniția noi sarcini până când limita nu este crescută. Sarcinile eșuate sau anulate nu sunt facturate.
  3. Salarul poate deveni negativ : partea costului efectiv care depăşeşte soldul este înregistrată ca datorie, iar soldul apare negativ; creditele primite ulterior acoperă mai întâi datoria. Nu se pot începe noi angajări atâta timp cât soldul este negativ; actualizați soldul.

Clientii nu solicită niciodată „cât ar trebui să fie facturat”; serverul calculează suma finală pe baza a ceea ce a fost livrat.

GET /api/v1/billing/credits/operations?limit=20
GET /api/v1/billing/credits/operations/{operation_id}
GET /api/v1/billing/credits/jobs/{job_id}

Un înregistrare conține ID-ul operațiunii, starea, baza de facturare, precum și sumele încasate și rambursate. Cu o cheie API specifică, operațiunile includ doar cele inițiate de acea cheie.

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

Punctele de terminare ale utilizării returnează numărul de fișiere, caractere, tokeni și timpul de procesare al contului.

Verificarea soldului, stării sarcinilor, utilizării, înregistrărilor de plată, listelor de rezultate și a adreselelor de descarcare nu consumă credit.