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.
Verificați soldul
Section titled “Verificați soldul”GET /api/v1/billing/credits/balancecurl https://omnidoc.top/api/v1/billing/credits/balance \ -H "X-API-Key: $OMNIDOC_API_KEY"Câmpuri cheie:
| Câmp | Semnificație |
|---|---|
available | Milicredite disponibile acum, după datorie; negative în cazul datoriilor |
debt | Datorie î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. |
spent | Total milicredite achitate |
expired | Milicredite care au expirat sau au fost retrase |
today_charged | Millicreditele au fost compensate astăzi |
lots | Loturile de credit valabile în prezent și termenul lor de expirare |
Pachete de credit
Section titled “Pachete de credit”GET /api/v1/billing/credits/plansUn terminal public care nu necesită autentificare și returnează pachetele disponibile la vânzare (purchase_plans, indexate după codul plan). Disponibile acum:
| Codul planului | Credite | Preț | 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 (recomandat) | 50,000 | ¥129 | 16% |
credits_125000_v4 | 125,000 | ¥299 | 25% |
credits_450000_v4 | 450,000 | ¥999 | 35% |
- „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 valoarearecommended: true. Niciunul dintre aceste câmpuri nu apare dacă nu este setat. price_fen(în fen, 1/100 de yuan) este valabil pentru preț, iartotal_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ă.
Ciclu de încărcare
Section titled “Ciclu de încărcare”- 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șecquota_exceeded=true, o sarcină media se încheie cuerror_code=insufficient_credits) și nu se facturează nimic. Inițierea unei sarcini nu modifică saldul. - 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.
- 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.
Operații și înregistrări
Section titled “Operații și înregistrări”GET /api/v1/billing/credits/operations?limit=20GET /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.
Utilizare
Section titled “Utilizare”GET /api/v1/usage?limit=50GET /api/v1/usage/summaryPunctele de terminare ale utilizării returnează numărul de fișiere, caractere, tokeni și timpul de procesare al contului.
Query-urile sunt gratuite
Section titled “Query-urile sunt gratuite”Verificarea soldului, stării sarcinilor, utilizării, înregistrărilor de plată, listelor de rezultate și a adreselelor de descarcare nu consumă credit.