Открыть в интерактивной справке · markdown для агентов: https://neuraldeep.ru/docs/limits-api.md

Остатки лимитов · GET /v1/limits

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

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

# сервер уже свёл все блокеры (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.

Разделы справки (markdown для агентов)