Краткая справка по API

FAQ и лимиты API

Лимиты частоты и параллельных запросов, корректный retry после 429, правила баланса, документы и поддержка — в одном коротком справочнике.

Опубликованные лимиты

Значения идут по уровням баланса. RPM и параллелизм считаются по клиентскому аккаунту, сразу для всех его API-ключей.

RPM

Запросов в минуту

90 / 220 / 550 / 1 320 / 1 650

Лимит скорости действует на весь аккаунт и общий для всех его API-ключей. Индивидуальный лимит клиента может только уменьшить уровень RPM.

Concurrency

Одновременных запросов

4 / 10 / 25 / 60 / 75

Параллелизм определяется тем же уровнем баланса, что и RPM, действует на весь аккаунт и общий для всех его API-ключей. При превышении лимита API возвращает 429.

Ответы на частые вопросы

Что означает ответ 429?

429 означает превышение лимита частоты или одновременных запросов. Сначала проверьте заголовок Retry-After и повторяйте запрос только после указанной паузы.

Как правильно повторять запрос после 429?

Если Retry-After есть, используйте его. Если заголовка нет, не считайте любой 429 автоматически временным: проверьте HTTP-статус и публичный error.type, устраните постоянную причину и применяйте ограниченную экспоненциальную задержку только для временной ошибки.

Как устроены лимиты частоты?

Опубликованные уровни — 90, 220, 550, 1 320 и 1 650 запросов в минуту. Конкретный уровень определяется уровнем баланса. Ограничение скорости запросов действует на весь аккаунт и общее для всех его API-ключей; индивидуальный лимит может только уменьшить доступный RPM.

Сколько запросов можно выполнять одновременно?

Лимит одновременных запросов определяется тем же уровнем баланса и действует на весь аккаунт, то есть является общим для всех его API-ключей. Опубликованные уровни — 4, 10, 25, 60 и 75 одновременных запросов соответственно.

Что произойдёт, если закончится баланс?

При отсутствии доступного баланса API возвращает 402. Для ранее пополнявших клиентов в RU действует технический овердрафт до настроенного порога: ниже этого порога новые запросы приостанавливаются. Аккаунты без оплаты останавливаются при нулевом балансе.

Почему может прийти 402 при положительном балансе?

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

Какие документы получает организация?

В кабинете организации доступны договор и закрывающие документы. Сумма акта основана на фактически потреблённых услугах, а не на пополнениях. Для физического лица этот раздел недоступен.

Куда обратиться за поддержкой?

Авторизуйтесь и создайте тикет в разделе поддержки. Также можно написать на support@plusvibeapi.ru или в Telegram @maxadvent1. В кабинете указано, что на тикет ответят в течение 24 часов.

Начните работать с API

Создайте аккаунт, выберите модель и проверьте запросы по документации.