Tovább a tartalomhoz

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.

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

Kulcsmezők:

TérJelentés
availableMillicredit állomány most, adósság után; negatív adósság esetén
debtAdó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
expiredA lejárt vagy visszavont millicreditek
today_chargedMa rendezték a millicrediteket
lotsJelenleg érvényes hitel-lottók és azok lejárati ideje
GET /api/v1/billing/credits/plans

Egy 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ódKreditpontokÁrBónusz
credits_3000_v43,000¥9.90—
credits_10000_v410,000¥29.90—
credits_25000_v425,000¥698%
credits_50000_v4 (ajánlott)50,000¥12916%
credits_125000_v4125,000¥29925%
credits_450000_v4450,000¥99935%
  • A „Bónusz” a 10 000 hitelpont ára alapján számítódik, 29,90 jüanért, és a bonus_percent mező; az ajánlott csomagban a recommended: true van. 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 a total_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.
  1. 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 a quota_exceeded=true jelzéssel, egy médiamunka pedig a error_code=insufficient_credits jelzéssel zárul), és semmi nem kerül felszámolásra. Egy munka elindítása nem változtatja az egyenleget.
  2. 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.
  3. 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.

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

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

A felhasználási végpontok visszaadják a fiók fájljainak számát, karaktereit, tokenjeit és a feldolgozási időt.

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.