# Остатки лимитов · GET /v1/limits — neuraldeep.ru API

> Раздел машиночитаемой справки. Все разделы: https://neuraldeep.ru/llms.txt · всё одним файлом: https://neuraldeep.ru/llms-full.txt

Base URL: `https://api.neuraldeep.ru/v1`
Auth: `Authorization: Bearer $YOUR_KEY`

Сколько осталось от квоты именно у твоего ключа — session/week (чат и векторный класс отдельно), живое окно чат-RPM текущей минуты, cooldown'ы, параллельность, ночной множитель, кошелёк в рублях и процент kimi-бюджета. Тем же `Bearer sk-`, что и инференс. Сделано для агентов и кронов: планировать расход, а не узнавать о лимите из `429`.

```bash
curl -s https://api.neuraldeep.ru/v1/limits \
  -H "Authorization: Bearer $YOUR_KEY" | jq
```

```bash
# сервер уже свёл все блокеры (cooldown'ы, окна, RPM, статус ключа) в decision
curl -s https://api.neuraldeep.ru/v1/limits -H "Authorization: Bearer $YOUR_KEY" \
  | jq -e '.decision.can_request'

# тонкая настройка: тратить только если осталось >20% сессии
curl -s https://api.neuraldeep.ru/v1/limits -H "Authorization: Bearer $YOUR_KEY" \
  | jq -e '.chat.cooldown_sec == 0 and .chat.session.remaining > (.chat.session.limit / 5)'
```

Семантика: `decision` — сводка про chat-инференс (векторный лейн смотри в блоке `vector`); все числа уже эффективные (ночной ×2 применён — ничего не умножай); `remaining` посчитан на сервере и не бывает отрицательным; `key.status` ≠ `ok` означает 401 на инференсе независимо от остатков; при недоступных счётчиках — честный `503` c `Retry-After`. `decision.notices` — предупреждения, которые звать модели не мешают: `wallet_empty` значит, что ключ в режиме «Кошелёк», денег нет и он временно работает по правилам тарифа (бесплатные модели доступны, `can_request` из-за этого не гаснет). Ручка только читает — опрос квоту не тратит; чаще раза в 15-30 секунд поллить нет смысла.

> Потолки ТАРИФОВ (не персональные остатки) — `GET /api/public/tier-limits`: потоки, RPM и таймаут гейта. Объёмные квоты там не отдаются никому — свою смотри в `GET /api/me`, блок `limits`.