ChatGPT Claude Gemini: чек‑лист диагностики ошибок API‑ключей и ограничений доступа

В бэкенде подключены API ChatGPT, Claude и Gemini; чаще всего «падает» не потому, что модель плохая, а из‑за ошибки API‑ключа, отсутствия сетевого соединения или блокировок региональной политикой. Midjourney хоть и не работает по схеме с API‑ключами, но в Discord тоже встречаются сообщения о правах и квотах — по сути это то же самое: вам «не разрешено».

Самопроверка за 1 минуту: 90% API‑ошибок — здесь

• Ключ вставлен неправильно: лишние пробелы/переводы строк при копировании или «ключ проекта» использован как «личный ключ»
• Недостаточно прав у ключа: не включена оплата/не привязана карта/организация или проект не авторизованы для нужной модели
• Переменные окружения не применились: перезапускали сервис? в контейнере и на хосте не две ли разные конфигурации
• Прокси подвёл: то, что открывается веб‑страница, не значит, что бэкенд может напрямую достучаться до домена API — многие застревают именно здесь

Лечим по тексту ошибки

Пишет Unauthorized или Invalid API key

Не спешите сваливать вину на платформу: сначала заново сгенерируйте ключ в консоли, старый сразу аннулируйте; затем проверьте, правильное ли поле используется в заголовках запроса. При разработке ботов или плагинов, например у некоторых плагинов Koishi, ошибки часто возникают из‑за названия поля для ключа или формата вставки.

Пишет Rate limit или Quota exceeded

Это не «сломалось» — вы слишком интенсивно используете. Снизьте параллелизм, добавьте повторы с экспоненциальной задержкой; для стабильности переходите на тариф с более высокой квотой. У Midjourney, когда заканчивается fast, логика та же: переходите на медленную очередь и не нервничайте.

Пишет Network error или доступ ограничен

На бэкенд‑сервере проверьте прямое подключение к нужному домену через curl; если корпоративная сеть или канал из дата‑центра «за границу» нестабилен, смена линии часто эффективнее смены модели. Claude и Gemini более чувствительны к регионам и риск‑контролю — как только сетевое окружение «плывёт», триггеры срабатывают легче.

Как сделать проще

Если вам нужно просто «чтобы работало», не тратьте время на бесконечные попытки с оплатой, регионом и маршрутизацией. Можно сразу заглянуть в Titikey — там есть более беспроблемные варианты подключения и использования, чтобы оставить время на настоящее творчество и продукт.