Кредити та використання
Тарифіковані послуги оплачуються у вигляді кредитів на рахунку. Суми наводяться в мілікредитах (millicredits); 1000 мілікредитів дорівнюють 1 кредиту. Суми, які ви надсилаєте в запитах, мають бути цілими числами; суми на балансах та в записах можуть мати одну десяткову позицію (0,1 мілікредиту). credit_precision у відповідях становить 4, що означає максимум 4 десяткові знаки після перетворення на кредити.
Перевірте баланс
Section titled “Перевірте баланс”GET /api/v1/billing/credits/balancecurl https://omnidoc.top/api/v1/billing/credits/balance \ -H "X-API-Key: $OMNIDOC_API_KEY"Ключові поля:
| Поле | Значення |
|---|---|
available | Мілікредити доступні зараз, після сплати боргу; від’ємне значення — при наявності боргу |
debt | Заборгованість у мілікредитах: частина фактичної вартості завершених завдань, що перевищила залишок. Кредити, які надходять пізніше (доповнення балансу, щоденні гранти, коди для обміну, повернення коштів тощо), спочатку списуються на погашення заборгованості. |
spent | Загальна сума мілікредитів, яка була сплачена |
expired | Мілікредити, які закінчилися або були списані |
today_charged | Мілікредити було зараховано сьогодні |
lots | Діючі кредитні лоти та їх термін дії |
Пакети кредитів
Section titled “Пакети кредитів”GET /api/v1/billing/credits/plansПублічна кінцева точка, яка не вимагає входу та повертає набори у продажу (purchase_plans, індексовані за кодом плану). Зараз у продажу:
| Код плану | Кредити | Ціна | Бонус |
|---|---|---|---|
credits_3000_v4 | 3,000 | ¥9.90 | — |
credits_10000_v4 | 10,000 | ¥29.90 | — |
credits_25000_v4 | 25,000 | ¥69 | 8% |
credits_50000_v4 (рекомендовано) | 50,000 | ¥129 | 16% |
credits_125000_v4 | 125,000 | ¥299 | 25% |
credits_450000_v4 | 450,000 | ¥999 | 35% |
- «Бонус» розраховується від ціни 10 000 кредитів у розмірі ¥29,90 і відповідає полю
bonus_percent; рекомендований пакет має значенняrecommended: true. Жодне з цих полів не відображається, якщо воно не встановлено. price_fen(у фенах, 1/100 юаня) є авторитетним для ціни, аtotal_millicredits(мілікредити) — для кредитів. Придбані кредити не мають терміну дії; пакети можна купувати знову, і кожен раз вони надходять одним замовленням.
Життєвий цикл заряджання
Section titled “Життєвий цикл заряджання”- Баланс перевіряється відносно порогового значення перед початком завдання : баланс (після боргу) має бути вище порогового значення завдання, наприклад «сторінки × 2 кредити» для перекладу PDF, довжина вихідного тексту для інших файлів (щонайменше 2 кредити), а для аудіо, відео та мовлення — вартість, обчислена на основі тривалості або кількості символів, яку виміряв сервер (ціни в аудіо, відео та голоси ). За наявності API-ключу з бюджетом залишок бюджету ключа також має перевищувати порогове значення. В іншому разі відповідь є
402(завдання з перекладу файлу завершується з помилкоюquota_exceeded=true, завдання з мультимедіа завершується з помилкоюerror_code=insufficient_credits), і жодна сума не стягується. Початок завдання не змінює баланс. - Фактичне використання тарифікується після його завершення : переклад файлів (включаючи зображення), пакетна робота з форматованим текстом, операції над документами, аудіо, відео та мова тарифікуються повністю за фактичне використання після завершення. Бюджет API-ключів враховується лише під час перевірки перед початком і ніколи не зменшує суму оплати за завершену задачу; якщо це призведе до того, що використаний бюджет ключа перевищить його ліміт, ключ не зможе запускати нові завдання, поки ліміт не буде збільшено. Завдання, що завершилися з помилкою або були скасовані, не тарифікуються.
- Залишок може стати від’ємним : частина фактичної вартості, що перевищує залишок, фіксується як борг, і залишок відображається як від’ємний; надходження кредитів пізніше спочатку сплачують цей борг. Нові завдання не можуть початися, поки залишок є від’ємним; поповніть.
Клієнти ніколи не надсилають запит «скільки слід нарахувати»; сервер обчислює підсумкову суму на основі фактично наданих послуг.
Операції та записи
Section titled “Операції та записи”GET /api/v1/billing/credits/operations?limit=20GET /api/v1/billing/credits/operations/{operation_id}GET /api/v1/billing/credits/jobs/{job_id}Запис містить ідентифікатор операції, статус, базу для нарахування та суми списання й повернення. За наявності API-ключу в списку операцій будуть лише ті, які були ініційовані цим ключем.
Використання
Section titled “Використання”GET /api/v1/usage?limit=50GET /api/v1/usage/summaryКонечні точки використання повертають кількість файлів облікового запису, символи, токени та час обробки.
Запити безкоштовні
Section titled “Запити безкоштовні”Перевірка балансу, статусу завдань, використання, записів розрахунків, списків результатів та адрес завантаження не споживає кредити.