Ошибка «You exceeded your current quota, please check your plan and billing details»

Если при запросе к OpenAI API вы получаете ошибку «You exceeded your current quota, please check your plan and billing details» — это одна из самых частых проблем у разработчиков. Разберём, что она означает на самом деле и как её гарантированно исправить, в том числе из России.

Как выглядит ошибка

Error code: 429 - {
  'error': {
    'message': 'You exceeded your current quota, please check your plan and billing details. For more information on this error, read the docs: https://platform.openai.com/docs/guides/error-codes/api-errors.',
    'type': 'insufficient_quota',
    'param': None,
    'code': 'insufficient_quota'
  }
}

Ключевое здесь — type: insufficient_quota и code: insufficient_quota. Несмотря на HTTP-статус 429, это не ошибка частоты запросов (rate limit). Это значит, что на вашем аккаунте OpenAI закончились деньги или не настроен биллинг.

Чем insufficient_quota отличается от обычного 429

Многие путают две разные ошибки с одинаковым кодом 429:

Если у вас insufficient_quota — повторять запрос бесполезно, пауза не поможет. Проблема в деньгах, а не в скорости.

Почему возникает ошибка insufficient_quota

1. Закончились бесплатные пробные кредиты. Стартовые $5–18 от OpenAI сгорают через 3 месяца после регистрации, даже если вы их не потратили.
2. Не привязан способ оплаты. Новый аккаунт не может использовать API, пока в разделе Billing не добавлена карта и не куплены кредиты.
3. Закончился предоплаченный баланс. OpenAI давно перешёл на prepaid-модель: когда купленные кредиты заканчиваются, API сразу отдаёт insufficient_quota.
4. Карта не прошла оплату. Российские карты OpenAI не принимает, а иностранные виртуальные карты часто отклоняются или блокируются.
5. Новый проект/организация без отдельного биллинга. Если ключ создан в проекте, у которого нет своего лимита расходов.

Главная проблема для пользователей из России

Стандартное «решение» от OpenAI — зайти в platform.openai.com/account/billing, добавить карту и купить кредиты. Но из России это сделать невозможно:

• российские карты (Visa/Mastercard/МИР) не принимаются;
• для регистрации и биллинга нужен иностранный номер и адрес;
• VPN не помогает с оплатой и может привести к бану аккаунта;
• виртуальные иностранные карты часто отклоняются на этапе оплаты.

Получается замкнутый круг: API просит пополнить баланс, а пополнить его легальным способом из России нельзя.

Решение: AITUNNEL

AITUNNEL — российский сервис-посредник для OpenAI API. Вы работаете с тем же OpenAI SDK, но без биллинга OpenAI, без карты за рубежом и без VPN. Баланс пополняется в рублях, оплата идёт за фактическое использование — никаких ежемесячных подписок и сгорающих кредитов.

Почему ошибки insufficient_quota больше не будет

• Оплата в рублях — картой МИР, через СБП, для юрлиц по счёту.
• Pay-as-you-go — платите только за реально отправленные токены.
• Нет привязки карты OpenAI — биллинг OpenAI вам вообще не нужен.
• Прозрачный баланс — видно, сколько осталось, в личном кабинете.
• Минимальное пополнение от 399₽ — можно начать с маленькой суммы.

Как исправить за 5 минут

1. Зарегистрируйтесь на aitunnel.ru и получите API-ключ.
2. Пополните баланс в рублях (карта МИР или СБП).
3. В вашем коде замените base_url на адрес AITUNNEL и подставьте ключ AITUNNEL.
4. Запустите запрос — ошибка insufficient_quota исчезнет.

Было (ошибка 429 insufficient_quota)

from openai import OpenAI

client = OpenAI(api_key="sk-...")  # ключ напрямую от OpenAI

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Привет!"}]
)
# Error 429: You exceeded your current quota...

Стало (работает)

Чек-лист: что проверить при ошибке

• Точно ли в ответе insufficient_quota, а не rate_limit_exceeded? Если второе — это лимит частоты, добавьте retry.
• Есть ли положительный баланс на аккаунте (у AITUNNEL — в личном кабинете)?
• Правильный ли base_url и API-ключ в коде?
• Не используете ли вы старый ключ от прямого аккаунта OpenAI вместо ключа AITUNNEL?

Другие частые ошибки OpenAI

Часто задаваемые вопросы

Я подождал и повторил запрос — ошибка осталась. Почему? Потому что insufficient_quota не связана со временем. Пауза помогает только при rate_limit_exceeded. Здесь нужно пополнить баланс.

У меня были бесплатные кредиты, но ошибка появилась. Пробные кредиты OpenAI сгорают через 3 месяца после регистрации. После этого API требует платный баланс.

Нужно ли мне настраивать биллинг OpenAI? Нет. При работе через AITUNNEL биллинг OpenAI не нужен — вы пополняете рублёвый баланс AITUNNEL.