Skip to main content
GET
Retrieve TTS API usage data
Returns generated-audio minutes for each (date, voice, style, language, model) combination over the requested period. Both preset voices and custom voices appear in the response. For bucketed analytics with custom breakdowns (e.g. by api_key), use Get usage instead.
Dates are UTC+0. Maximum query window is 30 days.

Endpoint

Query parameters

Request example

Response example

Notes

  • If no usage was recorded in the window, usages is an empty array.
  • total_minutes_used reflects the actual length of generated audio (the same length used for credit deduction).
  • Useful for monthly budget reports and identifying which characters drive the most cost.

See also

Docs: Cost and usage

Operational patterns: weekly reports, anomaly alerts, attribution.

Get usage

Bucketed analytics with multi-dimensional breakdowns.

Authorizations

x-sup-api-key
string
header
required

Query Parameters

start_date
string
required

The start date in YYYY-MM-DD format.

Example:

"2024-11-01"

end_date
string
required

The end date in YYYY-MM-DD format.

Example:

"2024-11-30"

Response

A list of TTS API usage records matching the specified date range.

usages
object[]
required