Kredit és használat
A számlázható szolgáltatások a fiókegyenlegben kerülnek elszámolásra. Az összegek millicreditekben vannak megadva (millicredits); 1000 millicredit egyenlő 1 kredittel. A kérelmekben küldött összegeknek egész számoknak kell lenniük; az egyenlegekben és nyilvántartásokban szereplő összegek legfeljebb egy tizedesjegyig pontosak lehetnek (0,1 millicredit). A válaszokban szereplő credit_precision értéke 4, ami azt jelenti, hogy a kreditekké való átváltás után legfeljebb 4 tizedesjegy van.
Ellenőrizze az egyensúlyt
Szekció neve “Ellenőrizze az egyensúlyt”GET /api/v1/billing/credits/balancecurl https://omnidoc.top/api/v1/billing/credits/balance \ -H "X-API-Key: $OMNIDOC_API_KEY"Kulcsmezők:
| Tér | Jelentés |
|---|---|
available | Millicredit állomány most, adósság után; negatív adósság esetén |
debt | Adósság millicreditben: a teljesített feladatok tényleges költségének azon része, amely meghaladta az egyenleget. A később érkező kreditek (feltöltések, napi támogatások, beváltott kódok, visszatérítések stb.) először az adósságot fizetik ki. |
spent | Összesen rendezett millicredit |
expired | A lejárt vagy visszavont millicreditek |
today_charged | Ma rendezték a millicrediteket |
lots | Jelenleg érvényes hitel-lottók és azok lejárati ideje |
Hitelcsomagok
Szekció neve “Hitelcsomagok”GET /api/v1/billing/credits/plansEgy bejelentkezést nem igénylő nyilvános végpont, amely a kiárusított csomagokat adja vissza (purchase_plans, tervezettkód szerint kulcsolt). Most akciós:
| Tervkód | Kreditpontok | Ár | Bónusz |
|---|---|---|---|
credits_3000_v4 | 3,000 | ¥9.90 | — |
credits_10000_v4 | 10,000 | ¥29.90 | — |
credits_25000_v4 | 25,000 | ¥69 | 8% |
credits_50000_v4 (ajánlott) | 50,000 | ¥129 | 16% |
credits_125000_v4 | 125,000 | ¥299 | 25% |
credits_450000_v4 | 450,000 | ¥999 | 35% |
- A „Bónusz” a 10 000 hitelpont ára alapján számítódik, 29,90 jüanért, és a
bonus_percentmező; az ajánlott csomagban arecommended: truevan. Egyik mező sem jelenik meg, ha nem van beállítva. - A
price_fen(fen, 1/100 jüan) a hivatalos ár egysége, míg atotal_millicredits(millicredit) a kredit egysége. A megvásárolt kreditek nem járnak le; a csomagok újra megvásárolhatók, és minden alkalommal egyben érkeznek.
Töltési életciklus
Szekció neve “Töltési életciklus”- Az egyenleget a küszöbértékkel összehasonlítják, mielőtt egy munka elindul : az egyenleg (adósság után) a munka küszöbértéke felett kell hogy legyen, például „oldalak × 2 kredit” a PDF fordításnál, a forrás szöveg hossza más fájlok esetén (legalább 2 kredit), és hang-, videó- és beszédanyagok esetén a szerver által mért időtartamból vagy karakterekből számított költség (árak hangek, videók és hangok ). Költségkerettel rendelkező API-kulcs esetén a kulcs maradék költségkerete is a küszöbérték felett kell hogy legyen. Ellenkező esetben a válasz
402(egy fájlfordítási munka sikertelenül zárul aquota_exceeded=truejelzéssel, egy médiamunka pedig aerror_code=insufficient_creditsjelzéssel zárul), és semmi nem kerül felszámolásra. Egy munka elindítása nem változtatja az egyenleget. - A tényleges felhasználás a befejezéskor kerül elszámolásra : A fájlfordulás (beleértve a képeket), a tömeges formázott szöveg, a dokumentumkezelési műveletek, az audio-, video- és beszédfunkciók teljes összege a tényleges felhasználás alapján kerül elszámolásra a befejezéskor. Egy API-kulcs költségkerete csak a megkezdés előtti ellenőrzésnél számít be, és soha nem csökkenti a már befejezett feladat díját; ha ezáltal a kulcs felhasznált költségkerete meghaladja a limitet, a kulcs újabb feladatokat nem indíthat, amíg a limit nincs emelve. A sikertelen vagy törölt feladatok nem kerülnek elszámolásra.
- Az egyenleg negatív értéket is felvehet : a tényleges költségnek az egyenleget meghaladó része adósságként kerül nyilvántartásra, és az egyenleg negatív értéket mutat; a később beérkező jóváírások először a tartozást fizetik ki. Az egyenleg negatív állapota esetén új munkafolyamatok nem indulhatnak; kérjük, töltse fel az egyenleget.
Az ügyfelek soha nem küldenek be olyan kérelmet, hogy „mekkora összeg legyen felszámolva”; a szerver a teljesített mennyiségből számolja ki a végleges összeget.
Műveletek és rekordok
Szekció neve “Műveletek és rekordok”GET /api/v1/billing/credits/operations?limit=20GET /api/v1/billing/credits/operations/{operation_id}GET /api/v1/billing/credits/jobs/{job_id}A rekord tartalmazza a művelet azonosítóját, állapotát, számlázási alapot, valamint a felszámolt és visszatérített összegeket. Egy API-kulccsal listázva a műveletek között csak azok jelennek meg, amelyeket az adott kulcs indított.
Használat
Szekció neve “Használat”GET /api/v1/usage?limit=50GET /api/v1/usage/summaryA felhasználási végpontok visszaadják a fiók fájljainak számát, karaktereit, tokenjeit és a feldolgozási időt.
A lekérdezések ingyenesek
Szekció neve “A lekérdezések ingyenesek”Az egyenleg, a munkafolyamatok állapota, a felhasználás, az elszámolási rekordok, az eredménylisták és a letöltési címek lekérdezése nem kerül hűségpontba.