Чек-лист по устранению ошибок 401/403/429 в API ChatGPT/Claude/Gemini/Midjourney

Подключаешь автоматизированное написание текстов, бота, RAG — весь комплект, и больше всего добивает не то, что результат так себе, а то, что API внезапно швыряет тебе в лицо 401/403/429. Я и сам наступал на эти грабли: ключ вроде правильный, а ошибка всё равно вылезает — будто споришь с воздухом.

Сначала разберись в трёх самых частых ошибках

• 401 Unauthorized: ключ недействителен, при вставке добавились лишние пробелы, использован ключ от другого проекта
• 403 Forbidden: ограничения по региону/правам/политикам организации или в аккаунте не включена нужная возможность
• 429 Too Many Requests: сработало ограничение по частоте, слишком высокая параллельность, исчерпана квота или достигнут лимит скорости

Частые причины ошибок API ChatGPT

Самые частые места, где я «падал»: в переменной окружения у ключа спереди/сзади оказывался перевод строки; ещё — биллинг не настроен, но кажется, что «раз работает, значит ок». При 429 снизь параллельность, добавь ретраи и экспоненциальную задержку — и всё сразу станет нормально.

Claude чаще упирается в права доступа

У Claude 403 во многих случаях не из‑за кода, а потому что аккаунт/регион/корпоративные политики не пропускают. А ещё ошибка в названии модели тоже заставляет сомневаться во всём — лучше ещё раз перепроверить поле модели в запросе.

У Gemini чаще всего дело в квотах и настройках проекта

Если Gemini выдаёт 429, не спеши ругать модель: сначала проверь квоты проекта, лимиты частоты вызовов и включён ли API, к которому привязан ключ; у некоторых ключ создан, но соответствующий сервис в консоли так и не включили.

Midjourney больше похоже на проблему на стороне Discord

Midjourney — это не классический поток API, а скорее взаимодействие через Discord. Типичные причины «не работает»: не выданы права каналу, бота нет на сервере, неверный формат команды или сработал rate limit. Сначала убедись, что бот видит твой канал — это надёжнее, чем бесконечно менять промпты.

Мой универсальный порядок проверки

• Скопируй ключ заново и вручную удали пробелы и переводы строк в начале/конце
• Убедись, что сеть стабильная: не то напрямую, не то через прокси
• Снизь параллельность до 1 для теста, затем постепенно увеличивай
• Внимательно смотри поле ошибки в теле ответа, а не только статус‑код

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