Справка
Лимиты
Главное для агента#
| Лимит | Значение |
|---|---|
| Запросов на ключ в минуту | 60 (REST и MCP вместе) |
| Запросов на ключ в сутки | 2000 (сутки UTC) |
| Запросов на студента в сутки | 3000 по всем ключам (сутки UTC) |
| Поиск и транскрипты | дополнительно 20 в минуту на ключ |
| Тело запроса MCP | до 64 KiB, один JSON-RPC объект |
Окна фиксированные. При превышении – 429 , заголовок Retry- и error. в теле; в MCP вызов инструмента возвращает isError: с тем же кодом. Подождите указанное время и повторите.
Общие правила#
Формат REST: {. Все коды, HTTP статусы и retry.
Для любого обработчика возможен 500 ; неизвестный URL – 404 , другой метод на зарегистрированном REST path – 405 . Для защищённых маршрутов дополнительно действуют проверки middleware: 401 , 403 при неподходящем типе credential; при scope – 403 . Неверные UUID, обрабатываемые parseParams, дают 404, а не 422.
Если у маршрута «отдельного throttle нет», это не обещание неограниченного использования, а отсутствие отдельного счётчика в текущем коде. Agent-key/OAuth лимиты REST и MCP общие: 60/min/key, 2000/UTC day/key, 3000/UTC day/student; transcript/search дополнительно 20/min/key. Окна фиксированные, при отказе 429 , Retry- и error.. Квоты создания ключей, файлов, диктовки и тьютора используют день МСК, пауза тьютора GLOBAL_ – UTC. Прокси может вернуть собственную ошибку без REST envelope (например, oversized body).
Лимиты по эндпоинтам#
| Эндпоинт | Лимиты |
|---|---|
POST | Защита от перебора: при превышении – 429 , повторить после Retry-. |
POST | Защита от перебора: при превышении – 429 , повторить после Retry-. |
POST | Защита от перебора: при превышении – 429 , повторить после Retry-. |
POST | Защита от перебора: при превышении – 429 , повторить после Retry-. |
POST | Защита от перебора: при превышении – 429 , повторить после Retry-. |
POST | Отдельного throttle в коде нет. |
POST | Отдельного throttle в коде нет. |
GET | Отдельного throttle в коде нет. |
POST | Отдельного throttle в коде нет. |
POST | Защита от перебора: при превышении – 429 , повторить после Retry-. |
POST | Защита от перебора: при превышении – 429 , повторить после Retry-. |
POST | Защита от перебора: при превышении – 429 , повторить после Retry-. |
GET | Отдельного throttle в коде нет. |
POST | 3/10 min/student; защита от перебора: при превышении – 429 , повторить после Retry-. |
POST | 5/10 min/student. |
GET | Agent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student. |
GET | Отдельного throttle в коде нет. |
GET | Agent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student. |
PATCH | Отдельного throttle в коде нет. |
PUT | Отдельного throttle в коде нет. |
POST | Отдельного throttle в коде нет. |
GET | Agent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student. |
GET | Agent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student. |
GET | Agent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student. |
GET | Agent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student. |
GET | Agent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student; дополнительно 20/min/key для этого тяжёлого метода. |
GET | Agent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student. |
GET | Agent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student. |
GET | Agent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student; дополнительно 20/min/key для этого тяжёлого метода. |
PUT | Agent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student. |
GET | Agent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student. |
PUT | Agent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student. |
POST | 1 запись одновременно; по умолчанию 1800 учитываемых секунд/день МСК; списание ceil(durationSec), минимум 10 секунд за вызов провайдера. |
GET | Отдельного throttle в коде нет. |
POST | 1 запуск одновременно на студента; сообщения и USD/день МСК из тарифа (Me.). Общая оценка изображений сообщения ≤10 000 tokens. |
GET | Отдельного throttle в коде нет. |
DELETE | Отдельного throttle в коде нет. |
POST | параллельные загрузки разрешены. Для PDF – до 2 резерваций на студента суммарно в обработке и ожидании. 20 попыток/день МСК, сброс в 00:00 МСК; отказы после резервирования дневной попытки тоже считаются, кроме отказа из-за занятости сервера: такая попытка возвращается в квоту. Превышение собственных 2 PDF-резерваций попытку расходует. Оба вида занятости дают 429 , сообщение «Сервер занят, попробуйте через минуту», retryAfterSec:; исчерпанная дневная квота – 429 . Лимит хранения – 200 MiB: все неприкреплённые и прикреплённые за последние 30 суток. |
GET | Отдельного throttle в коде нет. |
DELETE | Отдельного throttle в коде нет. |
GET | Отдельного throttle в коде нет. |
POST | До 3 активных персональных ключей; до 10 созданий за день МСК (включая rotation). |
POST | Те же ограничения создания: до 3 активных и 10 созданий/день МСК; заменяемый ключ не занимает дополнительный слот. |
DELETE | Отдельного throttle в коде нет. |
GET | Отдельного throttle в коде нет. |
GET | API-ключ / OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student. |
GET | API-ключ / OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student. |
GET | API-ключ / OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student. |
GET | API-ключ / OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student. |
GET | API-ключ / OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student. |
GET | API-ключ / OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student. |
GET | API-ключ / OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student. |
GET | API-ключ / OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student. |
GET | Отдельного throttle в коде нет. |