Лимиты
Все ограничения размеров и количества в одном месте — тело запроса, state и бюджет токенов, схема решения, назначения и доставки, идентификаторы, рабочее пространство, команда и вход.
Запросы к API
| Лимит | Значение | При превышении |
|---|---|---|
| Тело запроса | 128 КБ | 413 PAYLOAD_TOO_LARGE — "Request body is too large." |
| Тело запроса со схемой решения | 1 МБ — POST /mcp (validate_schema, create_decision, update_decision) и редактор приложения. State внутри по-прежнему ограничено 128 КБ | 413 PAYLOAD_TOO_LARGE — "Request body is too large." |
| Тело запроса на запуск | 32 МБ — POST /v1/decisions/{slug}, Playground и POST /v1/hooks/{token} (JSON, текст или multipart/form-data), чтобы state могло содержать файлы | 413 PAYLOAD_TOO_LARGE — "Request body is too large." |
Файлы в state (поля image, audio, file) | 20 МБ каждый, 24 МБ и 10 файлов в сумме; их текст обрезается примерно до 96 000 символов в сумме | 422 INVALID_STATE — "Field invoice is too large (…)" |
| State в сериализованном виде (без файлов) | 128 КБ и около 32 000 токенов (символы ÷ 4, то есть около 128 000 символов JSON) | 422 INVALID_STATE — "Field state is too large (…)" |
| Бюджет токенов на вызов | около 32 000 токенов на state плюс самый длинный вопрос, 64 000 на state плюс все вопросы | 422 INVALID_STATE — "The state plus … is too large …" |
| Элементы в list state | от 1 до 500 | 422 INVALID_STATE — "Field state has too many items (…)" |
| Запросов в минуту | 60 / 300 / 2 000 / 10 000 в зависимости от тарифа, на рабочее пространство — решения и чтение (GET /v1/decisions, /v1/me, /v1/executions) считаются отдельно | 429 RATE_LIMITED — см. Rate limits |
| Включённый объём | 1 млн в месяц на Genesis, больше на платных тарифах; сверх него решения оплачиваются предоплаченными кредитами, до необязательного лимита расходов на расчётный цикл | 402 CREDITS_EXHAUSTED без кредитов, 402 SPEND_CAP_REACHED при достижении лимита расходов — 402 QUOTA_EXCEEDED на тарифе с жёстким лимитом. См. Тарифы |
| Срок ответа движка | timeoutMs решения: по умолчанию 5 000 мс, от 500 до 30 000, включая повторы | 504 ENGINE_TIMEOUT |
Размер страницы GET /v1/executions | от 1 до 100, по умолчанию 20 | 400 INVALID_REQUEST |
Idempotency-Key | 1–128 символов из A–Z a–z 0–9 . _ : - | 400 INVALID_REQUEST |
X-Request-ID | 1–128 символов из того же набора | Заменяется сгенерированным ID req_… (без ошибки) |
| Идемпотентные повторы | 24 часа | Считается новым запросом |
Токены оцениваются как символы ÷ 4 сериализованного JSON. Бюджет токенов — это бюджет Jev: вопросы учитываются вместе с их инструкциями, вариантами, уровнями и критериями.
Схема решения
| Элемент | Лимит |
|---|---|
| Вопросов в решении | от 1 до 64 |
| Правил политик в решении | до 50 |
| Дополнительных условий AND в правиле | до 5 |
| Composites в решении | до 20 |
| Термов в composite | от 1 до 20 |
| Вес терма composite | от −100 до 100, не 0 |
| Поля state (object state) | до 50 |
| Элементы в list state | от 1 до 500 |
| Вариантов в вопросе choice | от 2 до 254, плюс other |
| Уровней в вопросе score | от 2 до 10 |
| Инструкции | от 1 до 8 000 символов |
context | до 8 000 символов |
| Описание варианта, уровень score, критерий probability | до 2 000 символов |
| Описание поля state | до 255 символов |
Строковое значение политики, label структурированного уровня | до 255 символов |
| Описание composite | до 500 символов |
| Ключи (поля, вопросы, composites, значения вариантов) | snake_case, до 48 символов |
minConfidence | от 0 до 1 |
timeoutMs | от 500 до 30 000 |
| Вся схема в сериализованном виде | до 1 МБ (тело, которое её несёт) |
Инструкции, описания вариантов, уровни score и критерии могут быть текстом или JSON; JSON измеряется по длине в сериализованном виде. См. Схема решения.
Решения
| Элемент | Лимит |
|---|---|
| Название | от 1 до 80 символов |
| Описание | до 500 символов |
| Slug | до 64 символов: строчные буквы, цифры и одиночные дефисы; фиксируется после первой публикации |
| Решений в рабочем пространстве | Genesis 2, Developer 10, Growth и Enterprise без ограничений (402 PLAN_LIMIT_REACHED) |
Рабочее пространство
| Элемент | Лимит |
|---|---|
| Активные API-ключи | 50 на рабочее пространство (409 CONFLICT — сначала отзовите неиспользуемый ключ) |
| Имя API-ключа | от 1 до 80 символов |
| Ключ провайдера (BYOK) | от 8 до 512 символов |
| Хранение журнала выполнений | Genesis 7, Developer 14, Growth 30, Enterprise 365 дней — или меньше, по настройке рабочего пространства |
| Playground | 30 запусков в минуту и 2 000 в день |
| Коды входа | 6 цифр, действуют 10 минут, 5 попыток, 3 кода на e-mail каждые 10 минут и 10 в день |
| Вход по паролю | 5 неверных попыток на e-mail, затем ожидание 15 минут |
| Пароль | от 10 до 128 символов, буквы и цифры |
Команда
| Элемент | Лимит |
|---|---|
| Ваших рабочих пространств | 10 (409 CONFLICT) |
| Приглашения | действуют 7 дней; 30 в час на рабочее пространство и на человека (429 RATE_LIMITED) |
| Ожидающие приглашения | 50 на рабочее пространство (409 CONFLICT) |
Назначения
| Лимит | Значение |
|---|---|
| Назначений в решении | 20 |
| Назначений, срабатывающих за выполнение | 10 |
Ответов LLM и агентов sync за выполнение | 3 |
| Условий в назначении | 5 |
| Параметров в назначении | 30 |
| Фиксированное значение параметра | до 500 символов |
| Заголовков в назначении | 20 |
| Значение заголовка | до 2 048 символов |
| URL | до 2 048 символов |
Шаблон тела http | до 10 000 символов |
| Описание назначения | до 2 000 символов |
| Текст ответа | до 4 000 символов |
| Кнопки ответа | до 10, до 80 символов каждая |
Промпт и входные данные LLM, instructions и input структурированного вывода | до 8 000 символов каждое |
| Инструкции агента | до 32 000 символов |
| Инструменты агента | до 50 |
Тайм-аут LLM и агента sync | от 1 000 до 25 000 мс, по умолчанию 20 000 |
maxTokens LLM | от 16 до 2 048, по умолчанию 512 |
temperature LLM | от 0 до 2, по умолчанию 0.3 |
Ответ агента, возвращаемый в response | до 16 000 символов |
| Попытки доставки | 6, примерно за 7 часов |
| Тайм-аут попытки доставки | 10 секунд |
| Доставок на рабочее пространство | 600 в минуту |
| Хранение доставок | 30 дней |
| Секреты рабочего пространства | 50, значения до 4 096 символов |
Сверх этих лимитов подходящее назначение пропускается с "reason": "limit", а некорректное назначение делает схему некорректной (422 INVALID_SCHEMA). См. Безопасность и лимиты назначений.
Идемпотентность
Безопасные повторы с заголовком Idempotency-Key — ключи резервируются до запуска, успешные вызовы повторяются из хранилища 24 часа, заголовок Idempotent-Replayed и IDEMPOTENCY_CONFLICT.
Обзор SDK
Официальные SDK для TypeScript и Python — что они добавляют к обычному HTTPS, чем отличаются и как собрать их из исходников, пока они не опубликованы в npm и PyPI.