Developer guide
Hata kodu
Durum koduna göre işlem ve yeniden deneme kuralları
Ağ geçidi, üst akış 4xx·5xx döndürdüğünde bu kodu olduğu gibi iletir; diğer durumlarda aşağıdaki tablonun kurallarını izler.
400·401·403·404·413, isteğin veya yapılandırmanın düzeltilmesi gereken kodlardır; 409·429·5xx ise istemcinin bekleyip aynı isteği yeniden göndermesi gereken kodlardır.
Hata gövdesinin biçimi spesifikasyona göre değişir ve Anthropic uyumlu yolun error.type değeri durum koduna göre belirlenir.
403'ün nedeni error.message ile ayırt edilir; limit ve kullanım değerleri konsol ekranından kontrol edilir.
Durum kodu
| Kod | Anlamı | İşlem |
|---|---|---|
| 400 | İstek değeri geçersiz. Anthropic uyumlu model listesindeki limit değeri 1~1000 aralığının dışındadır veya GET /responses/{responseId}?stream=true ile kaydedilmiş bir yanıtı akış olarak sürdürmeye çalıştınız. | Değeri aralık içinde olacak şekilde düzeltin. Kaydedilmiş yanıtları stream olmadan alın. |
| 401 | Anahtar yok veya süresi dolmuş ya da iptal edilmiş. | API anahtarları ekranından anahtarın durumunu kontrol edin ve üst bilgi adını ve Bearer ön ekini denetleyin. |
| 403 | Modele erişim izniniz yok, kullanım limitini aştınız, krediniz yetersiz veya sesin sahibi değilsiniz. | Nedeni error.message ile kontrol edin; sayısal değerleri aşağıdaki limitler ve kullanımı kontrol etme bölümündeki ekrandan doğrulayın. |
| 404 | Model yok veya bu anahtarla erişilemiyor (desteği sonlandırılmış modeller dahil). Var olmayan bir yolu çağırdığınızda veya saklama süresi olan 3 günü aşmış bir CleviDrive çıktısı istediğinizde de döndürülür. | Önce GET /models ile çağrılabilir model listesini kontrol edin. Yolu, API çağırma sayfasındaki tabloyla karşılaştırın. |
| 408 · 409 · 413 | Upstream zaman aşımı, yoğunluk veya istek boyutu aşımıdır. Ses ve voice yollarının zaman aşımı 5 dakika, istek üst sınırı ise 28 MiB'dir. | 409 yanıtında Retry-After varsa, belirtilen süre kadar bekledikten sonra aynı isteği yeniden gönderin. 413 için isteği bölerek gönderin. |
| 429 | Upstream sağlayıcısı hız sınırlaması uyguladı. | Retry-After varsa belirtilen süre kadar bekledikten sonra yeniden gönderin; yoksa üstel geri çekilmeyle yeniden deneyin. |
| 5xx | Ağ geçidinde veya upstream'de geçici bir hatadır (503 dahil). | Üstel geri çekilmeyle yeniden deneyin. Tekrarlanırsa iletişime geçin. |
402 döndürülmez. Yetersiz kredi ve kullanım limitinin aşılması durumlarının ikisi de 403 olarak döndürülür.
Yeniden deneme ve iletişim
Ağ geçidi kendi 429 yanıtını oluşturmaz ve upstream yanıtlarını sizin yerinize yeniden denemez veya kuyruğa almaz. Bekleme ve yeniden deneme işlemlerini istemci gerçekleştirir.
İletişime geçerken Yardım ve iletişim üzerinden X-Request-Id ile birlikte bildirin. X-Request-Id göndermediyseniz, sunucu tarafından verilen değer Anthropic uyumlu yanıtın request-id üst bilgisindedir.
Hata gövdesi
Hata gövdesinin biçimi spesifikasyona göre değişir. Upstream hataları yalnızca mesajı bırakılarak düzenlenip iletilir; yığın veya dahili alanlar iletilmez.
OpenAI uyumlu yolun hata gövdesidir.
{
"error": {
"message": "API key is required.",
"type": "invalid_request_error"
}
}Anthropic uyumlu yolun hata gövdesidir. error.type, durum koduna göre aşağıdaki tabloda belirtildiği şekilde belirlenir.
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "..."
},
"request_id": "rqid..."
}| Durum kodu | error.type |
|---|---|
| 400 | invalid_request_error |
| 401 | authentication_error |
| 403 | permission_error |
| 404 | not_found_error |
| 413 | request_too_large |
| 429 | rate_limit_error |
| 529 | overloaded_error |
| Diğer kodlar | api_error |
Limitleri ve kullanımı kontrol etme
Limit değerleri çalışma alanına göre değişir. 403 nedenini error.message ile kontrol ettikten sonra değerleri aşağıdaki ekranda kontrol edin.
| Kontrol edilecekler | Konsol ekranı |
|---|---|
| Çalışma alanına uygulanan limit | Genel bakış bölümündeki tahsis edilen kullanım limiti |
| Planın izin verdiği kapsam ve bakiye | Plan ve krediler |
| Gerçek kullanım (modele ve anahtara göre çağrı sayısı, tahmini düşülecek kredi) | Kullanım |
| Anahtar durumu (süresinin dolup dolmadığı veya iptal edilip edilmediği) | API anahtarları |