Расход платформы

Владелец и админ по сессии или ключ API, чей создатель всё ещё владелец или админ организации. По дням, ключам, моделям и компаниям, с токенами всех видов. Ключу не на все действующие компании — только его собственный расход, без разбивки по компаниям (by_company: null).

Доступно по ключу API.

GET /v1/workspaces/{ws}/platform/usage

Расход платформы

cURL

curl --request GET \
  --url https://api.tungo.kz/v1/workspaces/{ws}/platform/usage \
  --cookie tungo.session_token=

200

{
  "from": "2026-10-05T09:30:00.000Z",
  "to": "2026-10-05T09:30:00.000Z",
  "totals": {
    "requests": 123,
    "input_tokens": 123,
    "output_tokens": 123,
    "cache_write_tokens": 123,
    "cache_read_tokens": 123,
    "cost_tiyn": 123
  },
  "by_day": [
    {
      "day": "2026-11-06",
      "requests": 123,
      "input_tokens": 123,
      "output_tokens": 123,
      "cache_write_tokens": 123,
      "cache_read_tokens": 123,
      "cost_tiyn": 123
    }
  ],
  "by_key": [
    {
      "api_key_id": "<string>",
      "requests": 123,
      "input_tokens": 123,
      "output_tokens": 123,
      "cache_write_tokens": 123,
      "cache_read_tokens": 123,
      "cost_tiyn": 123
    }
  ],
  "by_model": [
    {
      "model": "<string>",
      "requests": 123,
      "input_tokens": 123,
      "output_tokens": 123,
      "cache_write_tokens": 123,
      "cache_read_tokens": 123,
      "cost_tiyn": 123
    }
  ],
  "by_company": [
    {
      "company_id": "<string>",
      "requests": 123,
      "input_tokens": 123,
      "output_tokens": 123,
      "cache_write_tokens": 123,
      "cache_read_tokens": 123,
      "cost_tiyn": 123
    }
  ]
}

Авторизации

sessionapiKeybearerKey

tungo.session_token · string · cookie · обязательно

Сессия кабинета: cookie ставит вход через /v1/auth/* (Better Auth), браузер шлёт её сам — фронтенду кабинета ничего добавлять не нужно (fetch с credentials: 'include'). За HTTPS имя cookie — __Secure-tungo.session_token. Сессия кончилась — 401 authentication_error: отправить на вход.

Параметры пути

ws · string · обязательно

id организации (workspace), ws_… — из GET /v1/workspaces

Параметры запроса

from · string<date-time> | null

Начало периода, ISO 8601 (включительно). Нет — 1-е число текущего месяца, 00:00 по Алматы

Пример:

"2026-10-01T00:00:00+05:00"

to · string<date-time> | null

Конец периода, ISO 8601 (не включительно); позже from и не дальше 400 дней от него. Нет — сейчас

Пример:

"2026-11-01T00:00:00+05:00"

Ответ

200

application/json

Расход

Расход платформы за период с разбивкой и токенами всех видов.

from · string<date-time> · обязательно

Начало периода, ISO 8601 UTC

Пример:

"2026-10-05T09:30:00.000Z"

to · string<date-time> · обязательно

Конец периода (не включительно), ISO 8601 UTC

Пример:

"2026-10-05T09:30:00.000Z"

totals · object · обязательно

Итоги за период

Show child attributes

by_day · object[] · обязательно

По дням (только дни с вызовами), по возрастанию даты

Show child attributes

by_key · object[] · обязательно

По ключам, дорогие сверху

Show child attributes

by_model · object[] · обязательно

По моделям, дорогие сверху

Show child attributes

by_company · object[] | null · обязательно

По компаниям, дорогие сверху; null — запрошено ключом не на все компании организации

Show child attributes