Usage & Billing

Monitor your account usage, check your credit balance, and view detailed breakdowns by module. Both endpoints require the TRANSCRIPTIONS_READ scope.

Get current usage

GET/dev/v1/usage

cURL

curl -X GET https://api.myvoicemaker.ai/dev/v1/usage \
  -H "Authorization: Bearer vmk_live_a1b2c3d4e5f6_8h9i0jKLmnOPqrSt"

Response — 200 Success

JSON

{
  "account_id": "acc_1a2b3c4d5e6f7g8h9i0j",
  "tier": "pro",
  "credits_remaining": 285000,
  "credits_used": 15000,
  "credits_total": 300000,
  "credits_expire": null,
  "created_at": "2026-03-03T10:30:00Z"
}

credits_total is included only once credits have been purchased. Purchased credits do not expire, so credits_expire is null.

Get usage breakdown

GET/dev/v1/usage/breakdown

Aggregate requests and credits per module over a date range.

Request parameters

Parameter	Type	Status	Description
`start_date`	string	Required	Start of the range, ISO 8601 (e.g. `2026-05-01T00:00:00Z`).
`end_date`	string	Required	End of the range, ISO 8601.
`module`	string	Optional	Filter by `tts`, `asr`, `animate`, or `explain`.

cURL

curl -X GET "https://api.myvoicemaker.ai/dev/v1/usage/breakdown?start_date=2026-05-01T00:00:00Z&end_date=2026-05-31T23:59:59Z" \
  -H "Authorization: Bearer vmk_live_a1b2c3d4e5f6_8h9i0jKLmnOPqrSt"

Python

from myvoicemaker import VoiceMaker

client = VoiceMaker(api_key="vmk_live_a1b2c3d4e5f6_8h9i0jKLmnOPqrSt")

report = client.usage.get_breakdown(
    start_date="2026-05-01T00:00:00Z",
    end_date="2026-05-31T23:59:59Z",
)
for entry in report.breakdown:
    print(entry.module, entry.requests, entry.credits_used)

Response — 200 Success

JSON

{
  "breakdown": [
    { "module": "tts", "requests": 150, "credits_used": 5000 },
    { "module": "asr", "requests": 45, "credits_used": 2000 },
    { "module": "animate", "requests": 5, "credits_used": 3750 },
    { "module": "explain", "requests": 80, "credits_used": 4250 }
  ],
  "total_requests": 280,
  "total_credits_used": 15000
}