Sign in

v1

latestOpenAPI 3.1.0Proprietary2026-08-0492426.9 KB
Usage

Your metered usage

Durable usage totals (requests, input characters, audio seconds) for the calling API key. Without parameters, lifetime totals. With start_time/end_time (ISO 8601), totals for that window at hourly granularity: the effective window snaps outward to hour boundaries and is echoed back in the response.

get/v1/usage

Query parameters

start_timestring date-time nullable

Window start (ISO 8601; naive = UTC). Snapped down to the hour. Omit both bounds for lifetime totals.

Window start (ISO 8601; naive = UTC). Snapped down to the hour. Omit both bounds for lifetime totals.

end_timestring date-time nullable

Window end (ISO 8601, exclusive; naive = UTC). Snapped up to the hour. Defaults to now when only start_time is given.

Window end (ISO 8601, exclusive; naive = UTC). Snapped up to the hour. Defaults to now when only start_time is given.

Response

Successful Response

key_idstring required

Non-secret identifier of the API key whose usage is summarized.

requestsinteger required
input_charsinteger required
input_audio_secondsnumber required
output_audio_secondsnumber required
first_request_tsnumber nullable

Unix time of the first metered request (lifetime queries).

last_request_tsnumber nullable

Unix time of the latest metered request (lifetime queries).

start_timestring date-time nullable

Effective (hour-snapped) window start; windowed queries only.

end_timestring date-time nullable

Effective (hour-snapped) window end, exclusive; windowed queries only.