Ошибки AI API: что делать с 401, 402, 429 и 503
Все неуспешные ответы нельзя обрабатывать одинаково. Ошибка ключа требует вмешательства, недостаточный баланс — пополнения, а временная недоступность допускает контролируемый повтор.
Постоянные ошибки
401 означает, что ключ отсутствует, неверен или отозван. 402 обычно сообщает о недостаточном балансе. Автоматический повтор не исправит эти состояния: остановите очередь, покажите понятную причину оператору и не создавайте лишнюю нагрузку.
- 401 — проверить Authorization и активность ключа
- 402 — проверить доступный баланс
- 400 — исправить структуру запроса или параметры модели
Лимиты и временные сбои
Для 429 уважайте Retry-After, если он передан. Для 503 применяйте экспоненциальную задержку со случайным разбросом и ограничьте число попыток. Не повторяйте запрос бесконечно и учитывайте, что операция могла дойти до модели до разрыва соединения.
Диагностика без утечки данных
Сохраняйте время, endpoint, модель, HTTP-статус и X-Request-Id. Не записывайте секреты и полный промпт по умолчанию. Request ID позволяет поддержке найти конкретную попытку, не раскрывая ключ.