Skip to content

keryx voice quota

Description

Show the voice provider's character quota — characters used this period, the period limit, the remaining headroom, and when the counter next resets. A read; it never synthesises or spends (spec 0016).

Voice generation (ElevenLabs) is billed per character, so this is the honest budget signal before a big VO run — more accurate than the configurable per-character cost estimate.

keryx voice quota
keryx voice quota --output json   # machine-readable

Usage

keryx voice quota

Behaviour

  • Resolves the configured voice provider (providers.voice) and reads its account quota. The default ElevenLabs provider reports it via its subscription API.
  • Prints characters: <used> / <limit> used (<remaining> remaining) and the reset date when the plan has one.
  • Errors clearly when the provider tracks no quota (a provider without the capability) or when the credential is missing/invalid.

Credentials

Needs the ElevenLabs credential (ELEVENLABS_API_TOKEN) like the other voice commands — resolved from the environment or the GTB keychain, never config.

The studio surfaces the same number as a remaining-characters indicator on the VO/music generation panels (GET /api/v1/quota).