Přeskočit na obsah

Kredity a použití

Zaúčtování zúčtovatelných služeb probíhá v kreditech účtu. Částky jsou uvedeny v milikredech (millicredits); 1000 milikredu odpovídá 1 kreditů. Částky, které odesíláte v požadavcích, musí být celá čísla; částky ve zůstatcích a záznamech mohou obsahovat jednu desetinnou čárku (0,1 milikredu). credit_precision v odpovědích je 4, což znamená maximálně 4 desetinná místa po převodu na kredity.

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

Klíčové pole:

PolíčkoVýznam
availableMillicredity jsou nyní k dispozici po zaplacení dluhu; záporné hodnoty znamenají dluh.
debtDluh v millicredeitech: část skutečných nákladů dokončených úloh, která překročila zůstatek. Kredity, které přicházejí později (doplnění, denní granty, kódy na uplatnění, refundace atd.), nejprve splácí tento dluh.
spentCelkový vyrovnání millicreditů
expiredMillicredity, které vypršely nebo byly staženy
today_chargedMillicredity byly dnes vyrovnány
lotsAktuálně platné kreditní loty a jejich expirace
GET /api/v1/billing/credits/plans

Veřejný koncový bod, který nevyžaduje přihlášení a vrátí balíčky v prodeji (purchase_plans, indexované podle kódu plánu). Nyní v prodeji:

Kód plánuKredityCenaBonus
credits_3000_v43,000¥9.90—
credits_10000_v410,000¥29.90—
credits_25000_v425,000¥698%
credits_50000_v4 (doporučeno)50,000¥12916%
credits_125000_v4125,000¥29925%
credits_450000_v4450,000¥99935%
  • „Bonus“ se vypočítává z ceny 10 000 kreditů za 29,90 ¥ a je to pole bonus_percent; doporučený balíček má recommended: true. Žádné z těchto polí se nezobrazí, pokud není nastaveno.
  • price_fen (v fen, 1/100 jüanu) je autoritou pro cenu a total_millicredits (milicredity) pro kredity. Zakoupené kredity nevyprší; balíčky lze nakupovat opakovaně a pokaždé dorazí najednou.
  1. Zůstatek je před zahájením úlohy ověřen vůči prahu : zůstatek (po odečtení dluhu) musí být vyšší než prahová hodnota pro danou úlohu, například „počet stran × 2 kredity“ pro překlad PDF, délka zdrojového textu u jiných souborů (alespoň 2 kredity) a u zvuku, videa a řeči náklady vypočítané z doby trvání nebo počtu znaků naměřených serverem (ceny ve zvuk, video a hlasy ). Pokud používáte API klíč s rozpočtem, zbývající rozpočet tohoto klíče také musí přesahovat prahovou hodnotu. V opačném případě je odpověď 402 (úloha překladu souboru končí jako neúspěšná s quota_exceeded=true, mediální úloha končí s error_code=insufficient_credits) a žádné poplatky nejsou účtovány. Zahájení úlohy nemění stav zůstatku.
  2. Skutečné využití se účtuje po jeho dokončení : překlad souborů (včetně obrázků), dávkový formátovaný text, operace s dokumenty, audio, video a řeč jsou účtovány v plné výši podle skutečného využití po dokončení. Rozpočet API klíče se pouze kontroluje před zahájením a nikdy neodpovídá na poplatky za dokončenou práci; pokud by tím došlo k překročení limitu využitého rozpočtu klíče, nemůže klíč zahajovat nové úlohy, dokud není limit navýšen. Neúspěšné nebo zrušené úlohy nejsou účtovány.
  3. Zůstatek může být záporný : část skutečných nákladů, která přesahuje zůstatek, je evidována jako dluh a zůstatek se zobrazuje jako záporný; kreditní platby doručené později nejprve splatí tento dluh. Nové zakázky nelze zahájit, pokud je zůstatek záporný; doplňte.

Klienti nikdy nepředkládají dotaz „kolik má být účtováno“; server vypočítá konečnou částku na základě dodaného množství.

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 operace, stav, základ pro fakturaci a účtované i vrácené částky. S uvedeným API klíčem jsou zahrnuty pouze ty operace, které byly spuštěny tímto klíčem.

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

Koncové body použití vracejí počet souborů, znaků, tokenů a čas zpracování účtu.

Kontrola zůstatku, stavu úloh, spotřeby, výpisů zúčtování, seznamů výsledků a adres pro stažení nevyužívá žádné kredity.