К содержанию
AgentOSДокументация
  • Загружаем индекс…
llms.txtКабинет

Справка

Лимиты

Главное для агента#

ЛимитЗначение
Запросов на ключ в минуту60 (REST и MCP вместе)
Запросов на ключ в сутки2000 (сутки UTC)
Запросов на студента в сутки3000 по всем ключам (сутки UTC)
Поиск и транскриптыдополнительно 20 в минуту на ключ
Тело запроса MCPдо 64 KiB, один JSON-RPC объект

Окна фиксированные. При превышении – 429 RATE_LIMITED, заголовок Retry-After и error.retryAfterSec в теле; в MCP вызов инструмента возвращает isError: true с тем же кодом. Подождите указанное время и повторите.

Общие правила#

Формат REST: { "error": { "code": "VALIDATION_FAILED", "message": "Некорректный запрос", "issues": [{"path":"field","message":"..."}] } }. Все коды, HTTP статусы и retry.

Для любого обработчика возможен 500 INTERNAL; неизвестный URL – 404 NOT_FOUND, другой метод на зарегистрированном REST path – 405 METHOD_NOT_ALLOWED. Для защищённых маршрутов дополнительно действуют проверки middleware: 401 UNAUTHENTICATED, 403 CREDENTIAL_NOT_ALLOWED при неподходящем типе credential; при scope – 403 INSUFFICIENT_SCOPE. Неверные 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 RATE_LIMITED, Retry-After и error.retryAfterSec. Квоты создания ключей, файлов, диктовки и тьютора используют день МСК, пауза тьютора GLOBAL_BUDGET – UTC. Прокси может вернуть собственную ошибку без REST envelope (например, oversized body).

Лимиты по эндпоинтам#

ЭндпоинтЛимиты
POST /api/v1/auth/link/inspectЗащита от перебора: при превышении – 429 RATE_LIMITED, повторить после Retry-After.
POST /api/v1/auth/link/redeemЗащита от перебора: при превышении – 429 RATE_LIMITED, повторить после Retry-After.
POST /api/v1/auth/oidc/startЗащита от перебора: при превышении – 429 RATE_LIMITED, повторить после Retry-After.
POST /api/v1/auth/oidcЗащита от перебора: при превышении – 429 RATE_LIMITED, повторить после Retry-After.
POST /api/v1/auth/tmaЗащита от перебора: при превышении – 429 RATE_LIMITED, повторить после Retry-After.
POST /api/v1/auth/tma/refreshОтдельного throttle в коде нет.
POST /api/v1/auth/logoutОтдельного throttle в коде нет.
GET /api/v1/auth/sessionsОтдельного throttle в коде нет.
POST /api/v1/auth/sessions/revoke-allОтдельного throttle в коде нет.
POST /api/v1/auth/password/loginЗащита от перебора: при превышении – 429 RATE_LIMITED, повторить после Retry-After.
POST /api/v1/auth/password/forgotЗащита от перебора: при превышении – 429 RATE_LIMITED, повторить после Retry-After.
POST /api/v1/auth/password/resetЗащита от перебора: при превышении – 429 RATE_LIMITED, повторить после Retry-After.
GET /api/v1/auth/passwordОтдельного throttle в коде нет.
POST /api/v1/auth/password/setup3/10 min/student; защита от перебора: при превышении – 429 RATE_LIMITED, повторить после Retry-After.
POST /api/v1/auth/password/change5/10 min/student.
GET /api/v1/meAgent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
GET /api/v1/me/avatarОтдельного throttle в коде нет.
GET /api/v1/onboardingAgent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
PATCH /api/v1/onboardingОтдельного throttle в коде нет.
PUT /api/v1/onboarding/setupОтдельного throttle в коде нет.
POST /api/v1/onboarding/submitОтдельного throttle в коде нет.
GET /api/v1/planAgent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
GET /api/v1/sectionsAgent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
GET /api/v1/lessonsAgent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
GET /api/v1/lessons/{id}Agent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
GET /api/v1/lessons/{id}/transcriptAgent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student; дополнительно 20/min/key для этого тяжёлого метода.
GET /api/v1/efirsAgent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
GET /api/v1/nextAgent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
GET /api/v1/searchAgent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student; дополнительно 20/min/key для этого тяжёлого метода.
PUT /api/v1/plan/milestonesAgent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
GET /api/v1/progressAgent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
PUT /api/v1/progressAgent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
POST /api/v1/transcribe1 запись одновременно; по умолчанию 1800 учитываемых секунд/день МСК; списание ceil(durationSec), минимум 10 секунд за вызов провайдера.
GET /api/v1/tutor/messagesОтдельного throttle в коде нет.
POST /api/v1/tutor/messages1 запуск одновременно на студента; сообщения и USD/день МСК из тарифа (Me.limits). Общая оценка изображений сообщения ≤10 000 tokens.
GET /api/v1/tutor/factsОтдельного throttle в коде нет.
DELETE /api/v1/tutor/facts/{id}Отдельного throttle в коде нет.
POST /api/v1/filesпараллельные загрузки разрешены. Для PDF – до 2 резерваций на студента суммарно в обработке и ожидании. 20 попыток/день МСК, сброс в 00:00 МСК; отказы после резервирования дневной попытки тоже считаются, кроме отказа из-за занятости сервера: такая попытка возвращается в квоту. Превышение собственных 2 PDF-резерваций попытку расходует. Оба вида занятости дают 429 RATE_LIMITED, сообщение «Сервер занят, попробуйте через минуту», retryAfterSec: 60; исчерпанная дневная квота – 429 DAILY_LIMIT. Лимит хранения – 200 MiB: все неприкреплённые и прикреплённые за последние 30 суток.
GET /api/v1/files/{id}Отдельного throttle в коде нет.
DELETE /api/v1/files/{id}Отдельного throttle в коде нет.
GET /api/v1/keysОтдельного throttle в коде нет.
POST /api/v1/keysДо 3 активных персональных ключей; до 10 созданий за день МСК (включая rotation).
POST /api/v1/keys/{id}/rotateТе же ограничения создания: до 3 активных и 10 созданий/день МСК; заменяемый ключ не занимает дополнительный слот.
DELETE /api/v1/keys/{id}Отдельного throttle в коде нет.
GET /api/v1/keys/callsОтдельного throttle в коде нет.
GET /api/v1/mentoring/trackAPI-ключ / OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
GET /api/v1/mentoring/track/versionsAPI-ключ / OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
GET /api/v1/mentoring/sessionsAPI-ключ / OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
GET /api/v1/mentoring/sessions/{sessionId}API-ключ / OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
GET /api/v1/mentoring/decisionsAPI-ключ / OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
GET /api/v1/mentoring/chat/digestsAPI-ключ / OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
GET /api/v1/mentoring/chat/messagesAPI-ключ / OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
GET /api/v1/mentoring/homeworkAPI-ключ / OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
GET /healthzОтдельного throttle в коде нет.