Usage

Расход по API-ключу за период

Возвращает итоговые расходы (рубли + копейки + токены + количество запросов) по тому API-ключу, которым сделан запрос; OAuth-токену — по всему подключению приложения (токен меняется каждый час, сумма — по всем токенам подключения). По умолчанию — последние 24 часа. Можно передать шорткат ?period= либо явные ?from=&to= (ISO 8601, UTC). Опциональный ?granularity= добавит массив buckets для построения графика.

get/v1/usage

Request

  • Base URL: https://api.hubris.pw
  • URL: https://api.hubris.pw/v1/usage
  • Auth: HTTP bearer

Query parameters

period'today' | '24h' | '7d' | '30d' | 'mtd'

Шорткат периода. today = с 00:00 UTC текущих суток. 24h = последние 24ч. 7d/30d = последние N суток. mtd = с 1-го числа текущего месяца UTC. Несовместим с from/to.

fromstring date-time

Начало периода, ISO 8601. Если задан — to тоже обязателен.

tostring date-time

Конец периода, ISO 8601. Если задан — from тоже обязателен.

granularity'hour' | 'day'

Если указан — в ответе появится массив buckets с агрегатами по этому шагу.

key_idstring uuid

Только management-ключом: сузить аккаунт-скоуп до одного API-ключа.

group_by'key' | 'model'

Только management-ключом: добавить разбивку by_key или by_model.

Response

Расход по ключу за указанный период.

object'usage' required
granularity'hour' | 'day' nullable required

Если granularity был задан, тут он же. Иначе null.

Example response

{
  "period": {
    "from": "2026-05-13T00:00:00.000Z",
    "to": "2026-05-14T00:00:00.000Z"
  },
  "scope": {
    "key_prefix": "sk-gw-a1b2...c3d4"
  },
  "totals": {
    "requests": 137,
    "prompt_tokens": 18420,
    "completion_tokens": 9610,
    "total_tokens": 28030,
    "cost_rub": 42.17,
    "cost_kopecks": "4217"
  },
  "buckets": [
    {
      "bucket": "2026-05-14T00:00:00.000Z",
      "cost_rub": 12.34,
      "cost_kopecks": "1234",
      "requests": 42
    }
  ],
  "by_key": [
    {
      "cost_kopecks": "1234"
    }
  ],
  "by_model": [
    {
      "cost_kopecks": "1234"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.