Когда пишешь скрипты автоматизации, ботов или подключаешься к workflow, больше всего выбивает из колеи не код, а внезапные ошибки: API key invalid, 401, 403, сетевой таймаут. Не спеши паниковать: в этой статье я по порядку, как сам наступал на грабли, собрал чек‑лист «проверяй по нему — и найдёшь причину». Подходит для ChatGPT, Claude и Gemini.
Сначала смотри на тип ошибки — не начинай сразу с переустановки
Многие считают любые проблемы «неверным ключом», и в итоге зря теряют время.
- 401: ключ недействителен, не передаётся, ошибка в формате/опечатка, проект/сервис не подключён
- 403: недостаточно прав, региональные/антифрод‑ограничения, блокировка политиками лимитов/квот
- 429: троттлинг (rate limit) или закончилась квота
- Таймаут/ENOTFOUND: проблемы сети/DNS/прокси, к ключу не относится
Частые причины «API‑ключ недействителен»
Опираясь на опыт отладки плагинов, где часто всплывают «ошибка API‑ключа» и ямы в конфигурации зависимостей, я выделил самые типичные причины:
- Лишние пробелы или перенос строки при копировании: особенно в переменных окружения — один пробел в конце заставит усомниться в реальности
- Использован ключ не той платформы: ключи OpenAI, Anthropic и Google нельзя смешивать — не пытайся засунуть ключ Gemini в конфиг Claude
- Неверные заголовки запроса: префикс Authorization, регистр имени header’а, забыли написать Bearer
- Не включена оплата/права в проекте: ключ настоящий, но у аккаунта не активированы нужные права на API — тоже будет отказ
403 (доступ ограничен): в первую очередь проверь регион и исходящий трафик
403 самый неприятный, потому что часто не говорит, «что именно не так». По моему опыту, сначала проверь исходящий IP и правила прокси, а уже потом — права аккаунта.
