Balance and billing
The unit is g. 1 g is one minute of audio at tariff ×1.
What a recording costs
The recording's length in minutes multiplied by the tariff of the paid options that are on:
| Options | Tariff | One minute of audio |
|---|---|---|
| no paid options | ×1 | 1 g |
| Personal data | ×1.2 | 1.2 g |
| Emotions: laughter and dissatisfaction | ×1.2 | 1.2 g |
| Call summary | ×1.3 | 1.3 g |
| every paid option | ×1.7 | 1.7 g |
The old emotion option (emotion classes) has been removed and is not billed: a request that still sends "emotion": true costs ×1; laughter and dissatisfaction are the Emotions option, voice_events (details).
The charge happens on completion, once the recording is recognised: 4 minutes 43 seconds with every option is 8.02 g. While a job is queued or running its estimate is held back from the available balance, so a burst of uploads cannot overdraw it. A failed job charges nothing.
Beta period
While the beta lasts there is no money behind the balance. Every midnight Tashkent time each account is topped up to its daily target, 240 g by default, that is four hours of audio at tariff ×1. The top-up is the difference to the target: spend 37 g during the day and +37 g arrives at night. An account already at the target gets no top-up and nothing appears in its history.
The target can be changed for a particular account by arrangement.
Promo codes
A one-off credit on top of the daily target: for a repost, for a partner, for conference attendees. A promo code carries hours of audio; type it on the Billing page and they land on the balance at once, as a promo line in the history. The nightly top-up only lifts a balance to its target and leaves one above it alone, so the credited hours stay until spent, and the daily top-up resumes once the balance drops below the target. One account redeems a code once; a code may have an expiry and a cap on redemptions. A credit an administrator makes by hand shows in the history as adjust with a note saying what for.
Where to look
- In the cabinet: the balance under your name in the left menu, and the "Billing" page with the history of top-ups and charges.
- In the API:
GET /v1/usagereturnsbalance_g,in_flight_g,available_gandtopup_target_g;GET /v1/billingreturns the balance and the history:
{"unit": "g", "balance_g": 203.63,
"transactions": [
{"kind": "charge", "amount_g": -5.65, "balance_after_g": 203.63, "job_id": "41f79b78-…", "seconds": 282.7, "factor": 1.2, "note": "", "created_at": "…"},
{"kind": "topup", "amount_g": 214, "balance_after_g": 240, "job_id": null, "note": "beta period", "created_at": "…"}
]}When the balance does not cover a recording, POST /v1/jobs answers 429 insufficient_balance with a hint saying what is there, what is needed and when the top-up comes.