Ошибки

HTTP	Значение	Рекомендуемое действие
400	Неверный запрос	Исправьте JSON и обязательные поля.
401	Неверный, замороженный или отозванный ключ.	Повернуть или разморозить ключ
402	Недостаточный баланс счета или достигнут лимит использования ключа.	Добавьте средства или сбросьте/увеличьте лимит ключей
403	Модель недоступна для ключа или исходного IP-адреса, отклоненного списком разрешений API.	Обновите разрешения ключа или используйте разрешенный исходный IP-адрес.
404	Неизвестная конечная точка, модель или асинхронный запрос.	Проверьте идентификатор и путь
413	Запрос слишком большой	Уменьшить размер контекста
429	Превышено число оборотов в минуту или параллелизм	Честь Retry-After
500	Ошибка шлюза	Повторите попытку и проверьте журналы
502/503/504	Восходящий поток недоступен или истекло время ожидания	Повторить попытку с экспоненциальной задержкой

Требуется оплата

Недостаточный баланс компании/счета возвращает HTTP 402 Payment Required в OpenAI-совместимом конверте:

{
  "error": {
    "message": "Insufficient account balance.",
    "type": "payment_required",
    "code": "insufficient_balance"
  }
}

Та же самая стабильная причина/код записывается в истории запросов. А 402 запрос отклоняется до исполнения поставщиком, и его не следует автоматически повторять до тех пор, пока финансирование или применимое ограничение расходов не будут исправлены.

Отклонение белого списка IP-адресов

Если аутентифицированный ключ API действителен, но исходный адрес находится за пределами действующего белого списка API для личных или корпоративных организаций, Model Gate отклоняет запрос перед восходящим выполнением. Ответы, совместимые с OpenAI, используют HTTP. 403 с кодом ip_not_allowed. Ответы, совместимые с Anthropic, используют конверт ошибок Anthropic с HTTP. 403 и authentication_error. Не повторяйте попытку из того же запрещенного источника; измените настроенный список разрешенных или отправьте запрос с разрешенного адреса.

Повторить попытку 429 после Retry-After. Повторить попытку 500, 502, 503, и 504 до трех раз с задержкой 1/2/4 секунды. Не повторяйте автоматически проверку, аутентификацию, баланс или необнаруженные ошибки.

Используйте публичный идентификатор запроса из X-Request-ID соотнести ответ с запросить журнал.