Accounts and costs
Who can use the API, how credits are charged, and the budgets and limits that apply.
- The API is included in paid plans. A free-plan account can use it with credits it purchased, and then only purchased credits pay; free monthly and sign-up credits never grant access. VIP accounts get access on approval.
- API work shares the account's credit wallet with the website. A narration costs one credit per character of its text (expressions - markers and audio tags - are not counted); a correction or regeneration charges only that sentence; a failed or canceled job is never charged.
- max_credits on creation refuses (422 max_credits_exceeded) a narration that would cost more. A key can have a monthly credit limit; an account can have a monthly API budget.
- Limits per account: 1 active job (VIP: 2), 10 queued jobs; 10 write and 60 read requests per minute; 10 previews per minute and 200 per day; 120 downloads per minute. 429 answers carry Retry-After. GET /me shows your exact values.
- Narrations created through the API appear in the website's project list with an API badge and can be edited there; both channels update the same narration and revisions.
cURL
curl -s "https://kolimina.com/api/public/v1/me" \
-H "Authorization: Bearer $KOLIMINA_API_KEY"cURL
curl -s "https://kolimina.com/api/public/v1/usage?from=2026-10-01T00:00:00Z" \
-H "Authorization: Bearer $KOLIMINA_API_KEY"