Грешки
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 да съпоставят отговора с дневник на заявките.