KAkalpalabs
Usage

Your metered usage

Changed on

Durable usage totals (requests, input characters, audio seconds) for the calling API key. Without parameters: lifetime totals, plus organization, your organization's generated audio against its allowance. 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.

get/v1/usage

Request

  • Base URL
    https://api.kalpalabs.ai
  • Auth
    HTTP bearer

Query parameters

start_timestring date-time nullable

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.

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.

Changes

  • c2e702455f84Revision changes
    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status