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

# Как устроен этот ключ

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

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

Имя, потолок расхода, срок действия и разрешённые модели ключа, которым сделан запрос. Значение ключа API не возвращает — его показывают один раз, при выпуске в кабинете.

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

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

## Ответы

### 200: Настройки ключа

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

- `id: integer` (required) — Идентификатор ключа. Значение ключа API не возвращает никогда
- `name: string` (required) — Имя ключа, которое дали при выпуске в кабинете
- `created_at: date-time` (required) — Когда ключ выпущен, UTC
- `limit_rub: string, decimal` (nullable) — Свой потолок расхода, ₽. `null` — ограничен остатком счёта
- `expires_at: date-time` (nullable) — Срок действия, UTC. `null` — бессрочный
- `models: array of string` (nullable) — Разрешённые модели. Пустой список — без ограничения; `null` — узнать не удалось, повторите запрос позже

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

```json
{
  "id": 42,
  "name": "backend-prod",
  "created_at": "2026-09-20T11:04:00Z",
  "limit_rub": "10000.00",
  "expires_at": null,
  "models": [
    "claude-sonnet-5",
    "claude-haiku-4.5"
  ]
}
```

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

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

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

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

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

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