Hatalar

HTTP	Anlam	Önerilen eylem
400	Geçersiz istek	JSON'u ve gerekli alanları düzeltin
401	Geçersiz, dondurulmuş veya iptal edilmiş anahtar	Anahtarı döndürün veya dondurmayı çözün
402	Yetersiz hesap bakiyesi veya anahtar kullanım sınırına ulaşıldı	Para ekleyin veya anahtar limitini sıfırlayın/artırın
403	API izin verilenler listesi tarafından reddedilen anahtar veya kaynak IP'si için model kullanılamıyor	Anahtar izinlerini güncelleyin veya izin verilen bir kaynak IP'si kullanın
404	Bilinmeyen uç nokta, model veya eşzamansız istek	Tanımlayıcıyı ve yolu kontrol edin
413	İstek çok büyük	Bağlam boyutunu azaltın
429	RPM veya eşzamanlılık aşıldı	Onur Retry-After
500	Ağ geçidi hatası	Günlükleri yeniden deneyin ve inceleyin
502/503/504	Yukarı akış kullanılamıyor veya zaman aşımına uğradı	Üstel geri çekilmeyle yeniden deneyin

Ödeme gerekli

Yetersiz şirket/hesap bakiyesi HTTP döndürüyor 402 Payment Required OpenAI uyumlu zarfta:

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

Aynı kararlı neden/kod İstek Geçmişi'ne kaydedilir. A 402 istek, sağlayıcının yürütülmesinden önce reddedilir ve finansman veya geçerli harcama kısıtlaması düzeltilene kadar otomatik olarak yeniden denenmemelidir.

IP izin verilenler listesinin reddedilmesi

Kimliği doğrulanmış bir API anahtarı geçerli olduğunda ancak kaynak adresi etkili kişisel veya Ticari kuruluş API izin verilenler listesinin dışında olduğunda Model Gate, yukarı yönde yürütmeden önce isteği reddeder. OpenAI uyumlu yanıtlar HTTP kullanıyor 403 kodlu ip_not_allowed. Antropik uyumlu yanıtlar, HTTP ile Antropik hata zarfını kullanır 403 Ve authentication_error. İzin verilmeyen aynı kaynaktan yeniden denemeyin; yapılandırılmış izin verilenler listesini değiştirin veya isteği izin verilen bir adresten gönderin.

Yeniden dene 429 sonrasında Retry-After. Yeniden dene 500, 502, 503, Ve 504 1/2/4 saniyelik geri çekilmeyle üç defaya kadar. Doğrulama, kimlik doğrulama, bakiye veya bulunamayan hataları otomatik olarak yeniden denemeyin.

Şuradaki istek genel kimliğini kullanın: X-Request-ID yanıtı ilişkilendirmek için istek günlüğü.