РАЗРАБОТКА · 7 МИН ЧТЕНИЯ

Ошибки AI API: 401, 403, 429 и 5xx — что означают

Краткая диагностика типовых кодов API и безопасные действия при неудачном запросе.

Код ошибки помогает понять, где возникла проблема: в авторизации, доступе к модели, лимите запросов или временной недоступности сервера. Сначала сохраните только обезличенную диагностическую информацию, не публикуя токены доступа.

401 — ошибка авторизации

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

403 — доступ запрещён

Возможны ограничения прав, модели, маршрута, региона или политики использования. Не пытайтесь обходить запрет подменой чужих учётных данных; проверьте Условия и обратитесь в поддержку.

429 — слишком много запросов

Это обычно сигнал о лимите скорости или квоте. Уменьшите параллельность, добавьте разумное ожидание и ограниченное число повторов. Бесконечные автоматические повторения могут создавать лишнюю нагрузку и расходы.

5xx и таймауты

Ошибка может быть временной, но повторный запрос иногда приводит к повторному использованию средств. Сверяйте историю операций и request ID; используйте идемпотентные механизмы, если они документированы для вашего маршрута. Подробнее — «Контроль расходов».


Материал обновлён: 6 ноября 2026 года. Доступность моделей и правила сторонних сервисов могут изменяться.