StatsResponseDto

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/apihubs-ru/json-schema/apihubs-ru-stats-response-dto-schema.json",
  "title": "StatsResponseDto",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/apihubs-ru-openapi.json#/components/schemas/StatsResponseDto",
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Фактически использованное начальное время периода (ISO 8601)"
    },
    "to": {
      "type": "string",
      "description": "Фактически использованное конечное время периода (ISO 8601)"
    },
    "totals": {
      "$ref": "#/$defs/StatsTotalsDto"
    },
    "byDay": {
      "description": "Расходы в день, по возрастанию, пропуски заполнены нулями",
      "type": "array",
      "items": {
        "$ref": "#/$defs/StatsBucketDto"
      }
    },
    "byModel": {
      "description": "Расходы по модели, сначала самые дорогие",
      "type": "array",
      "items": {
        "$ref": "#/$defs/StatsBucketDto"
      }
    },
    "byType": {
      "description": "Расход на тип генерации",
      "type": "array",
      "items": {
        "$ref": "#/$defs/StatsBucketDto"
      }
    }
  },
  "required": [
    "from",
    "to",
    "totals",
    "byDay",
    "byModel",
    "byType"
  ],
  "$defs": {
    "StatsBucketDto": {
      "type": "object",
      "properties": {
        "key": {
          "type": "string",
          "description": "Ключ корзины — дата (ГГГГ-ММ-ДД) или идентификатор модели"
        },
        "count": {
          "type": "number",
          "description": "Количество генераций в корзине"
        },
        "cost": {
          "type": "number",
          "description": "Потраченная сумма в корзине, в центах; исключая возвращенные за неудачные попытки"
        }
      },
      "required": [
        "key",
        "count",
        "cost"
      ]
    },
    "StatsTotalsDto": {
      "type": "object",
      "properties": {
        "balance": {
          "type": "number",
          "description": "Текущий баланс, в центах"
        },
        "spent": {
          "type": "number",
          "description": "Потрачено в выбранный период, в центах. Неудачные генерации возвращаются, поэтому они здесь не учитываются, хотя считаются запросами"
        },
        "spentAllTime": {
          "type": "number",
          "description": "Потрачено с момента регистрации, в центах; неудачные генерации, за которые был возврат, исключены"
        },
        "requests": {
          "type": "number",
          "description": "Генерации, созданные в течение периода"
        },
        "succeeded": {
          "type": "number",
          "description": "Генерации успешно завершены"
        },
        "failed": {
          "type": "number",
          "description": "Генерации, завершившиеся с ошибкой"
        },
        "inProgress": {
          "type": "number",
          "description": "Генерации, которые все еще выполняются"
        },
        "llmRequests": {
          "type": "number",
          "description": "Запросы чата LLM за период"
        },
        "llmTokens": {
          "type": "number",
          "description": "Потребленные токены LLM за период"
        }
      },
      "required": [
        "balance",
        "spent",
        "spentAllTime",
        "requests",
        "succeeded",
        "failed",
        "inProgress",
        "llmRequests",
        "llmTokens"
      ]
    }
  }
}