Перейти к содержанию

Лимиты и ограничения

При обработке запроса CoreInfra AI Hub последовательно проверяет формат и размер данных, список разрешенных моделей, недельные лимиты расходов и доступный остаток хаба, а после отправки запроса может вернуть ошибку от провайдера модели. Ниже описан каждый вид ограничений: кто им управляет, что именно считается, какой статус-код и формат ошибки возвращаются и как снять ограничение.

Баланс хаба​

  • Кто управляет: владелец и администраторы хаба (пополняют баланс в разделе «Оплата»).
  • Что учитывается: доступный остаток хаба в рублях — текущий баланс за вычетом суммы активных резервов по всем незавершенным запросам (Доступно = Баланс − Сумма активных резервов, подробнее — в разделе «Резервирование и списание»). Запрос допускается к отправке, пока доступный остаток строго больше нуля (Доступно > 0). Запросы к моделям подключенной подписки (за исключением отдельно включенной проверки конфиденциальных данных с помощью модели) и вызовы подсчета токенов (count_tokens, input_tokens) средства на балансе не резервируют; вызовы моделей других провайдеров через адреса подписок оплачиваются с баланса хаба.
  • Ошибка при нехватке средств:
    • Ответ со статус-кодом 400 (Content-Type: text/plain; charset=utf-8).
    • Заголовки ответа: x-coreinfra-status: payment-required и x-coreinfra-action-url со ссылкой на страницу пополнения баланса этого хаба (https://hub.coreinfra.ai/payments?hub_id=<UUID>).
    • Текстовое тело предлагает пополнить баланс на CoreInfra AI Hub (для владельца и администраторов также выводятся текущий баланс, сумма в резерве и доступный остаток).
  • Как снять ограничение: пополнить баланс через ЮКассу или активировать промокод в разделе «Оплата» (см. «Управление хабом»), либо дождаться завершения выполняющихся запросов, которые удерживают резерв.

Недельные лимиты расходов​

Для каждого платного запроса проверяется условие:

Расход за неделю + Активные резервы + Резерв нового запроса <= Действующий лимит
  • Кто управляет:
    • лимитом всего хаба и лимитом участника хаба — владелец и администраторы хаба в разделе «Настройки»;
    • лимитом отдельного ключа — владелец этого ключа на главной странице хаба.
  • Что учитывается: сумма списанных расходов за текущую календарную неделю (с понедельника 00:00 до следующего понедельника 00:00 в часовом поясе хаба, по умолчанию МСК UTC+3) плюс сумма активных резервов незавершенных запросов этой области и расчетный резерв нового запроса. Для лимита участника суммируются расходы и резервы по всем его ключам в этом хабе; для лимита ключа учитывается вся цепочка перевыпусков этого ключа. Если поверх базового недельного лимита задан временный повышенный лимит на текущую неделю, до конца недели проверка сравнивает сумму с временным лимитом, а с понедельника автоматически возвращается к базовому. Проверки выполняются по порядку: сначала лимит хаба, затем лимит участника, затем лимит ключа.
  • Ошибка при превышении лимита:
    • Ответ со статус-кодом 400 (Content-Type: text/plain; charset=utf-8) и заголовком x-coreinfra-status: cost-limit-reached.
    • В текстовом сообщении указано, какой именно лимит исчерпан — хаба, участника или ключа.
  • Как снять ограничение: временно повысить лимит на текущую неделю или убрать базовый лимит в настройках хаба, участника или ключа (пошаговая инструкция — в разделе «Командная работа и аналитика»), либо дождаться начала следующей недели в понедельник в 00:00.

Разрешенные модели​

  • Кто управляет:
  • Что учитывается: на каждом из трех уровней (хаб, участник, ключ) можно задать белый список разрешенных моделей. Если список на уровне пуст, этот уровень разрешает любые модели. Если в списке выбрана хотя бы одна модель, любые другие модели на этом уровне блокируются. Когда списки заданы сразу на нескольких уровнях, вызываемая модель должна входить в каждый из этих списков; проверка идет в порядке: хаб → участник → ключ.
  • Ошибка при блокировке модели:
    • Ответ со статус-кодом 400 (Content-Type: text/plain; charset=utf-8), в тексте которого указана заблокированная модель и уровень ограничения (настройки хаба, участника или ключа).
    • Если запрошенной модели нет в каталоге хаба, возвращается ответ со статус-кодом 400 (text/plain) о том, что модель не поддерживается.
  • Как снять ограничение: выбрать модель из разрешенного списка либо добавить нужную модель (или очистить фильтр кнопкой «Разрешить все модели») в настройках соответствующего уровня (см. «Командная работа и аналитика»).

Ограничения хаба на один запрос​

Эти ограничения задает хаб. Они проверяются до резервирования средств и обращения к провайдеру модели:

  • Размер тела и заголовков запроса:
    • Максимальный размер тела HTTP-запроса — 100 МиБ (104 857 600 байт); для сжатых POST-запросов этот предел действует как на сжатое, так и на распакованное тело. На /fal/api максимальный размер тела запроса составляет 64 МиБ. При превышении возвращается ошибка со статус-кодом 413.
    • Сжатие тела запроса (Content-Encoding) поддерживает gzip, deflate, br и zstd (размер окна zstd — до 8 МиБ). При другом алгоритме сжатия возвращается ошибка со статус-кодом 415 и заголовком Accept-Encoding: gzip, deflate, br, zstd.
    • Максимальный размер стартовой строки и заголовков HTTP/1-запроса — 64 КиБ (65 536 байт), время ожидания чтения заголовков — 30 секунд.
  • Токены и число элементов в запросе эмбеддингов (POST /openai/api/v1/embeddings):
    • Не более 300 000 токенов и не более 2048 элементов в массиве input в одном запросе. При превышении возвращается ошибка со статус-кодом 400 в формате ошибок OpenAI (code: "max_tokens_per_request" для лимита токенов).
  • Формат изображений, документов и файлов:
    • Все входные изображения и бинарные файлы передаются непосредственно в запросе в кодировке base64 (data:image/...;base64,..., блок source с type: "base64" в Anthropic Messages, поле data в Google Interactions или части multipart/form-data); для блоков document в Anthropic Messages также допускаются встроенный текст (text) и вложенный content.
    • Ссылки на внешние ресурсы (http(s)) и идентификаторы файлов в хранилище провайдера (file_id, files/...) отклоняются со статус-кодом 400 в формате ошибок вызванного протокола (на /fal/api — со статус-кодом 422).
    • В моделях принятия решений при конвертации изображений между OpenAI Decisions и TypeSafe System One принимаются только PNG и JPEG в кодировке base64, а размер преобразованного запроса ограничен 32 МиБ (при превышении возвращается ошибка со статус-кодом 400).

Ограничения отдельных протоколов и параметров (неподдерживаемые фоновые режимы, встроенные инструменты и др.) приведены на страницах соответствующих API: OpenAI, Anthropic, Google, xAI, OpenRouter, TypeSafe и fal.

Лимиты и ошибки провайдера​

  • Кто управляет: провайдер модели.
  • Что учитывается: частота запросов и токенов на стороне провайдера (rate limits), максимальное контекстное окно модели (context_window и max_output_tokens), правила безопасности контента и доступность инфраструктуры провайдера.
  • Ошибки со стороны провайдера:
    • Ограничение частоты запросов (429): возвращается ошибка со статус-кодом 429 в формате ошибок вызванного протокола и заголовками retry-after / retry-after-ms.
    • Временная недоступность провайдера (503): возвращается ошибка со статус-кодом 503.
    • Отклонение запроса по правилам контента или прав (403): возвращается ошибка со статус-кодом 403.
    • Превышение контекстного окна или ошибка параметров модели (400): возвращается ошибка со статус-кодом 400, а резерв освобождается без списания.
  • Как снять ограничение: при статус-коде 429 повторите запрос после интервала из retry-after / retry-after-ms, при 503 повторите запрос позже или переключитесь на другую модель, при 400 или 403 сократите длину диалога или скорректируйте параметры запроса.

Как определить причину ошибки​

Статус-код и признак в ответеКакое ограничение сработалоГде настраивается / что делать
400, заголовок x-coreinfra-status: payment-requiredИсчерпан доступный остаток хаба (Доступно <= 0)Пополнить баланс или ввести промокод в разделе «Оплата» (см. «Управление хабом»)
400, заголовок x-coreinfra-status: cost-limit-reachedИсчерпан недельный лимит расходов хаба, участника или ключаПроверить лимиты в разделе «Настройки» или у ключа на главной странице хаба (см. «Командная работа и аналитика»)
400 (text/plain), модель заблокирована настройкамиБелый список моделей хаба, участника или ключаДобавить модель в разрешенные в разделе «Настройки» или в настройках ключа на главной странице хаба
400 (text/plain), модель не поддерживаетсяМодель отсутствует в каталоге хабаПроверить идентификатор модели в «Каталоге моделей»
400 или 401, ошибка проверки ключаНе передан, поврежден или отозван ключ sk-ci2-...Проверить заголовок авторизации и активные ключи на главной странице хаба
400, ошибка вложения (ссылка на внешний ресурс или file_id)Передана ссылка на внешний ресурс или file_id вместо base64Передать изображение или файл в кодировке base64 (data:image/...;base64,...)
422 на /fal/apiНекорректные duration, resolution или ссылка в image_urlУказать duration от 5 до 20, поддерживаемое resolution и передать кадры через fal_client.encode_file()
400 на /openai/api/v1/embeddingsПревышен лимит 300 000 токенов или 2048 элементов inputРазбить входной массив на несколько запросов
413 Payload Too LargeТело запроса превышает допустимый размер (100 МиБ; на /fal/api — 64 МиБ)Уменьшить размер вложений или истории сообщений в запросе
415 Unsupported Media TypeНеподдерживаемый Content-EncodingСжимать запрос с помощью gzip, deflate, br или zstd либо отправлять без сжатия
429 Too Many RequestsЛимит частоты запросов у провайдера моделиПовторить запрос с учетом заголовков retry-after / retry-after-ms
503 Service UnavailableВременная недоступность провайдера моделиПовторить запрос позже или выбрать другую модель
403 ForbiddenЗапрос отклонен провайдером по содержимому или правилам моделиИзменить текст запроса или выбрать другую модель

Ограничения WebSocket​

После установления WebSocket ошибки передаются событиями error. Проверки баланса, расходов и разрешенных моделей выполняются для каждого оплачиваемого ответа в сессии.

Ограничения размера и времени задает сервер хаба:

  • Размер одного сообщения и кадра ограничен тем же значением, что и тело HTTP-запроса, — 100 МиБ. Превышение завершает соединение; уменьшите сообщение.
  • Соединение OpenAI Responses или Realtime живет не более часа (по истечении срока приходит событие error с кодом websocket_connection_limit_reached в Responses или session_expired в Realtime). Для продолжения откройте новое соединение.
  • В Realtime поле metadata у response.create может содержать не более 15 пар ключ–значение (при превышении приходит событие error с кодом metadata_full).

При неподдерживаемом или неудавшемся WebSocket Upgrade возвращается ответ со статус-кодом 426. Требования к подключению приведены в справочниках OpenAI Responses и Realtime.