Расход ключа, по которому пришёл запрос

Только по ключу API; как GET /v1/workspaces//api-keys//usage.

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

GET /v1/api-key/usage

Расход ключа, по которому пришёл запрос

cURL

curl --request GET \
  --url https://api.tungo.kz/v1/api-key/usage \
  --header 'x-api-key: <api-key>'

200

{
  "key_id": "<string>",
  "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-03",
      "requests": 123,
      "cost_tiyn": 123
    }
  ],
  "by_model": [
    {
      "model": "<string>",
      "requests": 123,
      "cost_tiyn": 123
    }
  ],
  "by_company": [
    {
      "company_id": "<string>",
      "requests": 123,
      "cost_tiyn": 123
    }
  ],
  "month": {
    "month": "2026-11-01",
    "spent_tiyn": 123,
    "cap_tiyn": 123
  }
}

Авторизации

apiKeybearerKey

x-api-key · string · header · обязательно

Ключ API организации: x-api-key: tg_…. Для серверных интеграций, не для кабинета: ключ — секрет, из браузера его не слать (CORS закрыт). Какие адреса пускают по ключу — x-api-key-access у операции.

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

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

Расход (в тиынах)

Расход ключа на ИИ за период: итоги, по дням, моделям и компаниям; суммы — в тиынах.

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

Ключ (key_…)

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_model · object[] · обязательно

По моделям ИИ, по алфавиту

Show child attributes

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

По компаниям

Show child attributes

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

Расход ключа за текущий месяц и его потолок — для полосы «потрачено из».

Show child attributes