Частота запросов
Распределяйте запросы рабочего пространства и обрабатывайте кратковременные ограничения.
Лимит частоты определяет, насколько быстро поступают запросы. Это отдельное ограничение от месячных вызовов и предоплаченного баланса и от сбрасываемых лимитов вызовов или денег ключа.
Где посмотреть действующий предел
Откройте Использование: там показаны текущая частота рабочего пространства и статус запроса на повышение. Для тарифицируемых запросов корпуса и химии предел общий для REST, MCP и тестовой среды; новый ключ не создаёт отдельную квоту пространства.
Действуют минутный счётчик и более короткий счётчик всплесков. Окна сбрасываются после периода неактивности, а не по началу календарной минуты. Распределяйте пакет во времени, не запускайте все задачи одновременно.
Заголовки ответа
Добавьте curl -i к небольшому запросу, чтобы увидеть заголовки:
curl --silent --show-error --include \
'https://api.cyberrxn.com/v1/chemistry/validate' \
-H "Authorization: Bearer $CYBERRXN_API_KEY" \
-H 'Content-Type: application/json' \
--data '{"reaction_smiles":"CCO>>CC=O","mode":"strict"}'Эта валидация тарифицируется. Если заголовки присутствуют, читайте их так:
| Заголовок | Значение |
|---|---|
X-RateLimit-Limit | Действующий предел пространства для 60-секундного счётчика |
X-RateLimit-Remaining | Оставшиеся запросы этого счётчика |
X-RateLimit-Reset | Время сброса этого счётчика в Unix-секундах |
Retry-After | Минимальная задержка до повтора ограниченного запроса |
X-Request-Id | Идентификатор обращения в поддержку |
Ограничитель всплесков может отклонить запрос, даже если минутный счётчик ещё не заполнен. Для 429 используйте Retry-After, а не задержку, рассчитанную только по минутным заголовкам.
Что делать при HTTP 429
- Прочитайте
code.request_rate_limitedозначает частоту;key_limit_reachedиworkspace_limit_reached— правила расхода. - Если повтор допустим, подождите не меньше
Retry-After/retry_after_seconds. - Повторите в пределах заданного числа попыток и времени. При повторных ограничениях уменьшите параллелизм.
- Не обрабатывайте нулевой лимит, истёкшее правило, отсутствие прав или исчерпанный баланс как слишком быстрый поток запросов.
SDK для Python и JavaScript уже повторяют подходящие сбои: по умолчанию до двух раз. Длительная задержка возвращается вызывающему коду вместо бесконечного ожидания. Учитывайте эти попытки, если добавляете собственный цикл повторов. Типизированные ошибки.
Как запросить повышение
Владелец или администратор пространства может запросить повышение в разделе «Использование». Отправка сама по себе не меняет предел; результат зависит от проверки.
API настроек частоты требует собственной сессии приложения. API-ключ для него не подходит. Пакетной обработке достаточно заголовков обычных запросов; административная сессия ей не нужна.