Перейти к основному содержанию
GET
Расход ключа, по которому пришёл запрос

Авторизации

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"

Ответ

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

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

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
обязательно

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

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

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

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

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

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

По компаниям

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

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