Temel hata grupları
Hata yanıtları error nesnesinde message, code ve type alanlarını taşır. Ham dahili hata gövdelerine dayanarak otomasyon kurma.
| Alan / durum | Açıklama |
|---|---|
| 400 invalid_messages / invalid_input | İstek yapısını düzelt |
| 400 invalid_output_limit | Çıktıyı 1–8192 aralığına getir |
| 401 invalid_token | Anahtar, süre veya kullanıcı durumunu kontrol et |
| 402 insufficient_balance | Kullanılabilir çalışma alanı bakiyesini kontrol et |
| 402 usage_reconciliation_required | Önceki isteğin kullanımını incelet |
| 403 workspace_access_revoked | Üyelik/yetkiyi yeniden kontrol et |
| 404 model_not_found | siber-v3 kimliğini kullan |
| 413 | JSON gövdesini küçült |
| 415 invalid_content_type | application/json gönder |
| 429 | Hız veya eşzamanlılık için bekle |
| 502 / 503 / 504 | Servis/bağlantı durumunu incele |
Güvenli hata raporu
Durum kodu, error.code, istek kimliği ve zamanı kaydet. Authorization başlığını veya tüm mesaj gövdesini hata izleme sistemine ekleme.
Tekrar deneme kararı
Geçersiz istek veya anahtar hatası aynı gövdeyle tekrar denenerek çözülmez. Çağrı başladıktan sonra kesilme yaşandıysa önce kullanım kaydını kontrol et. Bu API için otomatik, tam idempotent üretim tekrarı garantisi verilmez.