Лимиты
Сколько запросов может отправлять аккаунт и какого размера.
Лимиты считаются по всем ключам аккаунта вместе. Они одинаковы для всех аккаунтов.
| Лимит | Значение | При превышении |
|---|---|---|
| Запросов одновременно | 50 | 429, код too_many_running_requests |
| Запросов одновременно при балансе меньше $25 | По одному на каждые $0.5 баланса, не меньше 2 | 429, код low_balance_running_limit |
| Начатых запросов в минуту | 300 | 429 |
| Запросов с ответом в минуту | 120 | 429 |
| Размер одного запроса | 32 МБ | 413, код request_too_large |
| Данные всех выполняющихся запросов | 64 МБ | 429, код too_much_request_data |
| Сжатые запросы (Content-Encoding) | Не принимаются | 415 |
После 429 подождите пару секунд и повторите запрос: место освобождается, как только завершается один из выполняющихся. Официальные SDK повторяют запрос сами.
Запрос выполняется до конца, даже если вы отключились, с потоковым ответом или без, и оплачивается полностью. Своё место он занимает, пока не завершится.
Ошибки на стороне поставщика модели
Если поставщик модели не ответил, API возвращает 502 с кодом provider_error, а при его перегрузке 429 с кодом provider_rate_limited. Такие запросы не оплачиваются. Повторите запрос чуть позже; официальные SDK делают это сами.
Не поддерживается
Соединения WebSocket получают 400 с кодом websocket_not_supported: запрашивайте потоковый ответ по HTTP. Модели GPT принимают только форматы OpenAI (/v1/responses и /v1/chat/completions); в формате Gemini они отвечают 404.
Баланс
Запрос отклоняется с 403 и кодом insufficient_user_quota, когда баланса на него не хватает; в сообщении указано, где пополнить баланс. Стоимость входа резервируется до выполнения запроса, поэтому при почти пустом балансе большой запрос может не пройти, а маленькие ещё проходят. Когда баланс заканчивается, консоль предупреждает об этом, а вам приходит письмо или сообщение от нашего бота, если вы вошли через Telegram.
Свои лимиты
У каждого ключа может быть лимит трат, список разрешённых моделей, разрешённые IP-адреса и срок действия: их задают при создании ключа в разделе Консоль → API-ключи. Модели и адреса можно изменить позже. Ключ, исчерпавший свой лимит трат, отвечает 403 с кодом key_limit_reached.