Частые ошибки OpenAI API

Коротко. Это указатель по ошибкам OpenAI API (HTTP-ответы разработчика), не гайд по сбоям веб-чата ChatGPT. Полный и актуальный список — только в Error codes у OpenAI. chat-gpt.ru — независимые гайды на русском, не связан с OpenAI и API здесь не хостит.

Зачем эта страница

Слаг уже в индексе с апреля 2023: длинный перевод старой таблицы. Коды и формулировки у вендора с тех пор менялись (например, сценарии «неверный ключ» / «нет организации» в актуальных docs относятся к 401, а не к 404 из старого текста). Поэтому refresh короткий: куда идти в официальной документации и как отличить ключ, квоту и имя модели — без второго энциклопедического зеркала.

Старт по API на сайте: ChatGPT API. Выбор модели в линейке 5.6: GPT-5.6. Сбои входа на chatgpt.com — отдельная тема; сюда их не смешиваем.

Куда смотреть официально

1. Error codes — таблица кодов, причина и что делать; для billing смотрите error.code, а не только HTTP-статус.
2. Rate limits — лимиты запросов/токенов, заголовок Retry-After, когда retry уместен, а когда нет.
3. status.openai.com — если похоже на инцидент (часто рядом с 500/503).

Мы не копируем сюда полный перечень на «вечно»: сверка — по docs в день отладки.

Ключ, квота, модель

• Ключ / доступ. Неверный, отозванный или «чужой» ключ, нет членства в организации, IP вне allowlist — типично 401 (и соседние сценарии в docs). Правка ключа и настроек проекта, а не бесконечный retry.
• Квота / лимиты расхода. Исчерпан баланс кредитов, достигли organization/project spend limit или OpenAI-assigned usage limit — часто 429 с конкретным error.code (например credit_balance_exhausted). Retry без пополнения/смены лимита доступ не вернёт — так прямо пишет гайд Error codes.
• Скорость запросов. Другой класс 429: rate limit / slow_down. Темп, Retry-After, backoff — см. Rate limits.
• Модель. Неверное или недоступное имя модели, запрещённый service_tier и похожие — смотрите сообщение и параметры запроса в Error codes / карточке модели; для линейки 5.6 на сайте — хаб GPT-5.6, id и цены только у OpenAI.

Частые HTTP-коды (по docs)

Ниже — ориентир по официальной таблице, не полный каталог и не выдуманные коды:

• 401 — аутентификация: неверный ключ, нет организации, IP not authorized и др.
• 403 — страна/регион/территория не поддерживается (см. страницу поддержки в docs).
• 429 — rate limit, slow_down, credit/spend/usage limits (различайте по error.code).
• 500 — ошибка на стороне серверов OpenAI; краткий retry, затем status.
• 503 — модель временно перегружена (server_is_overloaded); Retry-After, если есть.

Старый live-текст ошибочно относил часть кейсов к 404 и вёл на устаревшие URL beta.openai.com — в этом refresh такие формулировки сняты.

Частые вопросы

Это про ошибки в окне ChatGPT?

Нет. Здесь — ответы API. Веб-чат и «сайт не открывается» — другие посадочные; этот URL их не дублирует.

Где полный актуальный список?

Только Error codes OpenAI. Локальная страница — указатель и карта интента.

Всегда ли помогает повторить запрос при 429?

Нет. Для временного rate limit — pacing и Retry-After. Для исчерпанных кредитов или spend/usage limit — сначала биллинг/лимиты в кабинете OpenAI, иначе retry бесполезен.

Это официальная справка OpenAI?

Нет. Независимый указатель chat-gpt.ru. Канон — developer docs и status OpenAI.

Дальше по API: ChatGPT API. Карта сайта: ChatGPT на русском.

Смотрите также: ошибки ChatGPT · не работает · гайды · формула запроса. chat-gpt.ru — независимый ресурс; ключи API и биллинг — у OpenAI, этот сайт ключи не выдаёт.