Ошибка 402: недостаточно средств
Ответ
Ошибка 402 значит, что запросу не хватает денег. Чего именно — говорит поле error.type:
insufficient_balance— не хватает баланса аккаунта;budget_exceeded— исчерпан бюджет API-ключа, баланс при этом может быть любым.
В error.metadata приходят available_rub (сколько доступно) и required_rub (сколько нужно этому запросу).
Когда приходит 402
- Баланс 0 ₽ и ниже. Отклоняется любой запрос к моделям, даже к бесплатным.
- Денег меньше, чем стоит вход запроса и короткий ответ. Для чата этого достаточно, чтобы запрос был принят.
- Баланс занят параллельными запросами. Сумма под запросы, которые выполняются прямо сейчас, для новых недоступна — в тексте ошибки будет «с учётом выполняющихся запросов».
- Эмбеддинги, картинки, озвучка, видео, batch. Не хватает на оценку стоимости запроса или на резерв задачи.
Большой max_tokens больше не вызывает 402
- Chat Completions и Messages (Anthropic): параметр
max_tokens - Responses API: параметр
max_output_tokens
Раньше перед запросом проверялся худший сценарий — ответ на весь лимит, а без лимита — на максимум модели, и запрос с небольшим балансом получал 402. Теперь такой запрос выполняется: вывод ограничивается числом токенов, на которое хватает денег, а в ответе приходит заголовок X-AITunnel-Output-Capped с этим числом. Если модель до него дошла, ответ заканчивается как при обычном лимите — finish_reason: "length".
Списывается, как и раньше, только фактически сгенерированное.
Что сделать
- Пополните баланс — или увеличьте бюджет ключа, если тип ошибки
budget_exceeded. - Если ответы обрезаются, а в заголовках есть
X-AITunnel-Output-Capped— денег хватает не на весь ответ: пополните баланс или задайтеmax_tokens/max_output_tokensпод задачу, например2048. - Сократите вход: длинная история диалога и большие документы стоят денег ещё до ответа.
Подробнее — в документации: ошибки и лимит расходов.
Быстрый старт с GPT 5
Пример вызова GPT 5 через AITUNNEL API:
from openai import OpenAI
client = OpenAI(
api_key="ваш_ключ_aitunnel",
base_url="https://api.aitunnel.ru/v1/"
)
response = client.chat.completions.create(
model="gpt-5",
messages=[
{"role": "user", "content": "Привет! Как дела?"}
]
)
print(response.choices[0].message.content)Похожие вопросы
- Какие модели OpenAI принимают картинки (Vision)?
- Какие модели Anthropic/Claude поддерживают распознавание картинок?
- Какие модели Google/Gemini поддерживают картинки?
- Какие модели OpenAI поддерживают tool calling?
- Какие модели Anthropic/Claude поддерживают tool calling?
- Какие модели Google/Gemini поддерживают tool calling?
Попробуйте сами через AITUNNEL
Получите API ключ и протестируйте модели. Работает из России без VPN, оплата в рублях.