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.
Zkontrolujte zůstatek
Section titled “Zkontrolujte zůstatek”GET /api/v1/billing/credits/balancecurl https://omnidoc.top/api/v1/billing/credits/balance \ -H "X-API-Key: $OMNIDOC_API_KEY"Klíčové pole:
| Políčko | Význam |
|---|---|
available | Millicredity jsou nyní k dispozici po zaplacení dluhu; záporné hodnoty znamenají dluh. |
debt | Dluh 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. |
spent | Celkový vyrovnání millicreditů |
expired | Millicredity, které vypršely nebo byly staženy |
today_charged | Millicredity byly dnes vyrovnány |
lots | Aktuálně platné kreditní loty a jejich expirace |
Kreditové balíčky
Section titled “Kreditové balíčky”GET /api/v1/billing/credits/plansVeř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ánu | Kredity | Cena | 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 (doporučeno) | 50,000 | ¥129 | 16% |
credits_125000_v4 | 125,000 | ¥299 | 25% |
credits_450000_v4 | 450,000 | ¥999 | 35% |
- „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 atotal_millicredits(milicredity) pro kredity. Zakoupené kredity nevyprší; balíčky lze nakupovat opakovaně a pokaždé dorazí najednou.
Životní cyklus nabíjení
Section titled “Životní cyklus nabíjení”- 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á squota_exceeded=true, mediální úloha končí serror_code=insufficient_credits) a žádné poplatky nejsou účtovány. Zahájení úlohy nemění stav zůstatku. - 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.
- 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í.
Operace a záznamy
Section titled “Operace a záznamy”GET /api/v1/billing/credits/operations?limit=20GET /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.
Použití
Section titled “Použití”GET /api/v1/usage?limit=50GET /api/v1/usage/summaryKoncové body použití vracejí počet souborů, znaků, tokenů a čas zpracování účtu.
Dotazy jsou zdarma
Section titled “Dotazy jsou zdarma”Kontrola zůstatku, stavu úloh, spotřeby, výpisů zúčtování, seznamů výsledků a adres pro stažení nevyužívá žádné kredity.