Грешки

HTTP кодове за грешки, формати на отговор и правила за повторен опит.

HTTP	Значение	Препоръчително действие
400	Невалидна заявка	Правилен JSON и задължителни полета
401	Невалиден, замразен или отменен ключ	Завъртете или размразете ключа
402	Недостатъчно салдо в акаунта или достигнат лимит за използване на ключове	Добавете средства или нулирайте/увеличете лимита за ключове
403	Моделът не е наличен за ключа или IP адреса на източника, отхвърлен от списък с разрешени API	Актуализирайте разрешенията за ключ или използвайте разрешен IP източник
404	Неизвестна крайна точка, модел или асинхронна заявка	Проверете идентификатора и пътя
413	Заявката е твърде голяма	Намалете размера на контекста
429	RPM или паралелност са надвишени	чест `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 да съпоставят отговора с дневник на заявките.

Грешки след заглавките на потока

SSE може да се провали, след като HTTP200 вече е изпратен. След това отговорът съдържа събитие за грешка, съвместимо с протокола; хронологията на заявките на шлюза записва повредата на терминала независимо от състоянието на кабела. Неизвестните съобщения нагоре са скрити по подразбиране, одобрените съобщения може да бъдат разкрити от политиката на администратора, а пълното разкриване на грешки нагоре е изрично. Вътрешните метаданни нагоре по веригата и временните суровини остават само за администратора. Липсващото използване след прекъснат поток е неизвестно/изисква се преглед, а не автоматична оценка от кабелни байтове. Запазете ID на заявката и опитайте отново само умишлено след проверка на частичен изход.