У тебя тоже бывал такой момент, когда хочется рвать и метать: подключаешь ChatGPT или Claude в сторонний клиент — отправляешь одну фразу и сразу 401/403; а в Gemini вроде бы ключ скопировал, но всё равно пишет, что он недействителен. Не спеши паниковать: в большинстве случаев это не «тебе нельзя пользоваться», а какой‑то мелкий нюанс, который тебя подставляет.
1) Сначала разберись, какая именно ошибка
401 чаще всего означает, что ключ введён неправильно/не передан; 403 больше похоже на права доступа, регион или то, что проект/доступ не активирован; 429 — это квота или лимитирование. Для начала сохрани скрин с кодом ошибки — дальше при проверке сэкономишь половину времени.
2) Проблема в самом ключе — самое частое и самое абсурдное
- при копировании добавился пробел или перенос строки (особенно если копируешь из документа)
- перепутал «видимый ключ» с «реальным ключом» (на некоторых платформах полный ключ показывают только один раз)
- перепутал окружение: тестовый ключ вставил в прод
Небольшое ворчание: многие «ошибки API-ключа» на деле — это невидимый пробел. Глазом не увидеть, а программа тебе поблажек не сделает.
3) Права и переключатели не включены: думаешь, что включил, а на самом деле нет
Для Gemini типично — API не включён в нужном проекте; для API ChatGPT также нужно проверить проект и статус биллинга. Для Claude, если подключаешь через слой инструментов, посмотри, прокинул ли инструмент права/разрешения корректно.
4) Прокси и регион дают «ложный фейл»
Если один и тот же ключ не работает в корпоративной сети, но работает через мобильный хот-спот — почти наверняка проблема в сетевом маршруте. Сначала исключи влияние прокси, DNS, корпоративного шлюза и т. п., а уже потом ругай продукт.
