---
title: "Статистика использования и расходов для текущего пользователя"
method: GET
path: "/api/v1/stats"
tags: ["Управление аккаунтом"]
---

# Статистика использования и расходов для текущего пользователя

`GET /api/v1/stats`

## Request

- Base URL: `https://api.apihubs.ru`
- URL: `https://api.apihubs.ru/api/v1/stats`
- Auth: HTTP bearer

## Query parameters

- `range` 'today' | '7d' | '30d' | 'custom'
- `from` string
- `to` string

## Response `200`

- StatsResponseDto
  - `from` string, required: Фактически использованное начальное время периода (ISO 8601)
  - `to` string, required: Фактически использованное конечное время периода (ISO 8601)
  - `totals` StatsTotalsDto, required
    - `balance` number, required: Текущий баланс, в центах
    - `spent` number, required: Потрачено в выбранный период, в центах. Неудачные генерации возвращаются, поэтому они здесь не учитываются, хотя считаются запросами
    - `spentAllTime` number, required: Потрачено с момента регистрации, в центах; неудачные генерации, за которые был возврат, исключены
    - `requests` number, required: Генерации, созданные в течение периода
    - `succeeded` number, required: Генерации успешно завершены
    - `failed` number, required: Генерации, завершившиеся с ошибкой
    - `inProgress` number, required: Генерации, которые все еще выполняются
    - `llmRequests` number, required: Запросы чата LLM за период
    - `llmTokens` number, required: Потребленные токены LLM за период
  - `byDay` StatsBucketDto[], required: Расходы в день, по возрастанию, пропуски заполнены нулями
    - `key` string, required: Ключ корзины — дата (ГГГГ-ММ-ДД) или идентификатор модели
    - `count` number, required: Количество генераций в корзине
    - `cost` number, required: Потраченная сумма в корзине, в центах; исключая возвращенные за неудачные попытки
  - `byModel` StatsBucketDto[], required: Расходы по модели, сначала самые дорогие
    - `key` string, required: Ключ корзины — дата (ГГГГ-ММ-ДД) или идентификатор модели
    - `count` number, required: Количество генераций в корзине
    - `cost` number, required: Потраченная сумма в корзине, в центах; исключая возвращенные за неудачные попытки
  - `byType` StatsBucketDto[], required: Расход на тип генерации
    - `key` string, required: Ключ корзины — дата (ГГГГ-ММ-ДД) или идентификатор модели
    - `count` number, required: Количество генераций в корзине
    - `cost` number, required: Потраченная сумма в корзине, в центах; исключая возвращенные за неудачные попытки

## Other responses

- `401`: Ошибка авторизации

---

[API](https://skmtc.dev/apihubs/apis/api-hubs-api.md) · [All operations](https://skmtc.dev/apihubs/apis/api-hubs-api/llms.txt) · [OpenAPI document](https://skmtc.dev/apihubs/apis/api-hubs-api/revisions/491c66fb97dd?raw)