Больше всего выводит из себя не то, что модель «не умеет писать», а то, что ты только собрался начинать, а консоль швыряет: API key invalid, 401, network error. Чаще всего я спотыкался вот о что: с ключом всё ок, проблема — в «обвязке» и сопутствующих настройках. Этот чек-лист я составил в порядке, в котором чаще всего пользуюсь: ChatGPT, Claude, Gemini.
Сначала убедись, что используешь правильный ключ и правильный проект
Многие копируют старый ключ, тестовый ключ, или переключают проект в консоли и не замечают. Советую прямо в кабинете провайдера создать новый ключ и сразу один раз заменить — не воюй со старым окружением.
Не включены права и биллинг — считай, что ключа нет
401/403 не обязательно означают, что ключ неверный: часто просто не включён биллинг, не хватает области прав, или действуют ограничения организации/проекта. С Claude и Gemini особенно часто бывает так: «вроде работает», а при обращении к API сразу ошибка — не спрашивай, откуда знаю.
Переменные окружения и пробелы — скрытые убийцы
Лишний пробел в .env, необработанный перенос строки, или то, что платформа деплоя не подставила переменные, — всё это превращается в «ключ недействителен». Вывести длину ключа в лог и сделать trim по краям полезнее, чем полчаса пялиться в ошибку.
