Когда пишешь код и подключаешься к ChatGPT, Claude, Gemini, больше всего бесит не то, что модель «не умная», а то, что она вообще тебя игнорирует: по очереди прилетают 401, 403, 429. Ниже — набор проверок, которым я пользуюсь чаще всего: он почти всегда возвращает проблему «API не работает» из области мистики в реальность.
Тип ошибок №1: 401 — недействительный ключ или неверная подпись
Увидели invalid_api_key, Unauthorized — не спешите сомневаться в себе: чаще всего при копировании добавился лишний пробел, потерялся префикс или вы подсунули ключ от тестового окружения в прод.
- Убедитесь, что ключ получен на правильной платформе: OpenAI, Anthropic, Google — не смешивайте
- Проверьте заголовки запроса: правильно ли указан формат Bearer
- Проверьте минимальным запросом, не начинайте сразу с кучи параметров
Тип ошибок №2: 429 — лимит запросов или закончилась квота
429 выглядит как проблема сети, но на самом деле чаще означает «слишком активно используете».
- Ограничьте параллелизм, сделайте повтор с экспоненциальной задержкой
- Сверьте биллинг и квоты: в Gemini и Claude не перепутайте проект/организацию
- Длинные тексты по возможности режьте, а промпты держите по принципу KISS: проще — часто стабильнее
Тип ошибок №3: 403 — блокировка по региону или риск‑контроль
403 часто означает не «нет прав», а то, что платформа считает вас «подозрительными». Корпоративная сеть, IP дата‑центра, частая смена узлов — всё это легко триггерит блокировки.
