> Расположение: Методы API → Ключ и расход
> Краткое содержание: Расход этого ключа
> Это Markdown-версия конкретной страницы. Для контекста за её пределами (правила API, полный перечень методов, авторизация) ОБЯЗАТЕЛЬНО открой [llms.txt](https://vcpay.ru/ai/docs/llms.txt) перед ответом — это сэкономит токены и предотвратит неполный ответ.

# Расход этого ключа

**Метод**: `GET`

**Путь**: `/v1/vcpay/stats`

Запросы, токены и рубли этого ключа за текущие сутки (с 00:00 UTC) и за последние 30 суток. Другие ключи счёта сюда не входят.

Рубли появляются, когда запрос тарифицирован, — в ближайшие минуты после ответа модели. Пока этого не случилось, `priced` равен `false`.

## Пример запроса

```bash
curl "https://llm.vcpay.ru/v1/vcpay/stats" \
  -H "Authorization: Bearer ВАШ_КЛЮЧ"
```

## Ответы

### 200: Расход ключа за сутки и за 30 дней

**Схема ответа:**

- `today: object` (required) — С 00:00 UTC текущих суток
  - `requests: integer` (required) — Завершённых запросов к моделям
  - `prompt_tokens: integer` (required) — Токенов на входе
  - `completion_tokens: integer` (required) — Токенов на выходе, включая размышления модели
  - `cached_tokens: integer` (required) — Токенов входа, прочитанных из кэша
  - `cost_rub: string, decimal` (required) — Тарифицированный расход за окно, ₽
- `last_30d: object` (required) — Последние 30 суток до момента запроса
  - `requests: integer` (required) — Завершённых запросов к моделям
  - `prompt_tokens: integer` (required) — Токенов на входе
  - `completion_tokens: integer` (required) — Токенов на выходе, включая размышления модели
  - `cached_tokens: integer` (required) — Токенов входа, прочитанных из кэша
  - `cost_rub: string, decimal` (required) — Тарифицированный расход за окно, ₽
- `priced: boolean` (required) — Расход уже тарифицирован. `false` — нули в `cost_rub` означают «ещё не посчитано», а не «бесплатно»

**Пример ответа:**

```json
{
  "today": {
    "requests": 214,
    "prompt_tokens": 412300,
    "completion_tokens": 51870,
    "cached_tokens": 120400,
    "cost_rub": "237.61"
  },
  "last_30d": {
    "requests": 5127,
    "prompt_tokens": 9884100,
    "completion_tokens": 1240300,
    "cached_tokens": 3011200,
    "cost_rub": "5604.18"
  },
  "priced": true
}
```

### 401: Ключ не передан или не распознан. Отозванный, удалённый и несуществующий ключ отвечают одинаково — что с ключом, видно в кабинете

**Схема ответа при ошибке:**

- `detail: string` (required) — Что случилось, по-русски

**Пример ответа:**

```json
{
  "detail": "Ключ не распознан. Если он выпущен давно, перевыпустите его в кабинете"
}
```

### 429: Слишком много запросов: не больше 10 в секунду с одного адреса, и не больше 120 в минуту на ключ. Повторите после паузы

