HydraCore
API by router

Usage

Budget Status

Budget status for an instance. Reads from llm_usage_events (authoritative source).

GET
/v1/usage/budget-status
AuthorizationBearer <token>

In: header

Query Parameters

instance_idInstance Id
Formatuuid

Response Body

curl -X GET "https://loading/v1/usage/budget-status?instance_id=497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "budget_daily_usd": 0,
  "by_model": {},
  "instance_id": "06587974-2dbe-4e10-8bf9-38cce0f5a366",
  "remaining_usd": 0,
  "spent_today_usd": 0
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Usage Summary

Usage summary with drill-down by customer/instance/model/key_source.

GET
/v1/usage/summary
AuthorizationBearer <token>

In: header

Query Parameters

period?Period

today|week|month

Default"today"
group_by?Group By

Group by: customer, instance, model, or key_source

Default"customer"
customer_id?Customer Id
instance_id?Instance Id

Response Body

curl -X GET "https://loading/v1/usage/summary?period=today&group_by=customer&customer_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&instance_id=497f6eca-6276-4993-bfeb-53cbbbba6f08"
{}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}