usage

Your monthly allowance: limit, used, remaining, percent, and what it buys per model

The allowance is BILLED SECONDS, and each model spends it at its own rate: a second of Kokoro costs 1.5, a second of XTTS costs 3. So there is one percentUsed, and byModel[].remainingSeconds says how much audio the remainder buys in each model — those are ALTERNATIVES drawn from the same pot, not separate budgets.

limitSeconds and remainingSeconds are null when the account is unmetered. Exceeding the allowance answers 402 QUOTA_EXCEEDED — deliberately not 429, because waiting does not help until resetsAt.

The aggregate numbers ride on every synthesis response as X-Ditto-Quota-* headers, so an integration can watch its own headroom without polling this.

get/v1/usage/quota

Request

  • Base URL: https://api.ditto.audio (the document declares no server; this is the origin it was published from)
  • URL: https://api.ditto.audio/v1/usage/quota
  • Auth: HTTP bearer

Changes

No recorded changes to this operation across all 1 revision of this API.