Skip to main content
GET
/
api
/
v1
/
budgeting
/
usage
/
costs
Python (SDK)
from meetkai_mka1 import SDK


with SDK(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.usage.costs(start_time=624757, end_time=189930, group_by="")

    # Handle response
    print(res)
{
  "currency": "<string>",
  "start_time": 123,
  "end_time": 123,
  "group_by": [
    "<string>"
  ],
  "data": [
    {
      "service": "<string>",
      "task_type": "<string>",
      "model": "<string>",
      "api_key_id": "<string>",
      "team_id": "<string>",
      "user_id": "<string>",
      "external_user_id": "<string>",
      "org_id": "<string>",
      "cost": 123
    }
  ],
  "total_cost": 123
}

Authorizations

Authorization
string
header
required

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Query Parameters

start_time
integer
required

Window start, epoch seconds (inclusive)

Required range: -9007199254740991 < x <= 9007199254740991
end_time
integer
required

Window end, epoch seconds (exclusive)

Required range: -9007199254740991 < x <= 9007199254740991
group_by
string
default:""

CSV of grouping dimensions: service, task_type, model, api_key_id, team_id, user_id, external_user_id, org_id

org_id
string

Target org (cluster admins only; omit for cluster-wide)

Minimum string length: 1

Response

200 - application/json

OK

currency
string
required
start_time
number
required
end_time
number
required
group_by
string[]
required
data
object[]
required
total_cost
number
required