Developer guide
Xəta kodları
Status kodlarına əsasən görüləcək tədbirlər və təkrar cəhd qaydaları
Bu səhifədə şlüzün qaytardığı status kodları və onların mənaları, həmçinin hər kod üzrə görüləcək tədbirlər ümumiləşdirilir.
Upstream 4xx·5xx qaytararsa, həmin kod olduğu kimi ötürülür; digər hallarda aşağıdakı cədvələ əməl edilir.
İki uyğunluq standartında xəta mətninin quruluşu, Anthropic uyğunluğunda error.type qaydaları, həmçinin limitləri və istifadəni yoxlamaq üçün konsol ekranı da təqdim olunur.
Status kodu
| Kod | Məna | Görüləcək tədbir |
|---|---|---|
| 400 | Sorğu dəyərində xəta. Anthropic uyğun model siyahısında limit 1~1000 aralığından kənardadır və ya GET /responses/{responseId}?stream=true ilə saxlanılmış cavabı davam etdirməyə cəhd edilib | Dəyəri icazə verilən aralığa düzəldin. Saxlanılmış cavaba stream olmadan baxın. |
| 401 | Açar yoxdur və ya açarın müddəti bitib, yaxud açar ləğv edilib | API açarları səhifəsində açarın vəziyyətini yoxlayın, başlıq adını və Bearer prefiksini nəzərdən keçirin. |
| 403 | Modelə giriş icazəsi yoxdur, istifadə limiti aşılıb, kredit kifayət etmir və ya səsin sahibi deyilsiniz | error.message səbəbi fərqləndirir. Rəqəmlərə aşağıdakı limitləri və istifadəni yoxlama bölməsindəki ekrandan baxın. |
| 404 | Model mövcud deyil və ya bu açarla ona giriş mümkün deyil (dəstəyi başa çatmış modellər də daxil olmaqla), yol mövcud deyil və ya 3 günlük saxlama müddəti keçmiş CleviDrive çıxışı | Əvvəlcə GET /models ilə çağırıla bilən modellərin siyahısını yoxlayın. Yolu API çağırma səhifəsindəki cədvəllə müqayisə edin. |
| 408 · 409 · 413 | Upstream vaxt aşımı, sıxlıq və ya sorğu ölçüsünün həddən artıq olması. Səs və voice yolları üçün vaxt limiti 5 dəqiqə, sorğu limiti isə 28 MiB-dir | 409 cavabında Retry-After varsa, həmin müddət qədər gözləyin. 413 üçün sorğunu hissələrə bölüb göndərin. |
| 429 | Upstream təminatçısı sürət limiti tətbiq etdikdə | Retry-After varsa, ona olduğu kimi əməl edin; yoxdursa, eksponensial geriçəkilmə ilə yenidən cəhd edin. |
| 5xx | Şlüzün və ya upstream-in müvəqqəti xətası (503 daxil olmaqla) | Eksponensial geriçəkilmə ilə yenidən cəhd edin. Problem təkrarlanarsa, X-Request-Id ilə birlikdə yardım və əlaqə kanalları vasitəsilə bizə bildirin. |
Yenidən cəhd
Şlüz öz 429 kodunu yaratmır, upstream cavabını gizlicə yenidən cəhd etmir və növbəyə də qoymur.
Gözləmə və yenidən cəhd işlərini klient həyata keçirir.
| Kod | Gözləmə müddəti | Sonra |
|---|---|---|
| 409 | Retry-After varsa, həmin müddət | Eyni sorğunu yenidən göndərin. |
| 429 | Retry-After varsa, həmin müddət; yoxdursa, eksponensial geriçəkilmə | Eyni sorğunu yenidən göndərin. |
| 5xx | Eksponensial geriçəkilmə | Təkrarlanarsa, müraciət edin. |
| 413 | Gözləmə yoxdur | Sorğunu hissələrə bölüb göndərin. |
Xəta mətni
Xəta mətninin formatı spesifikasiyadan asılı olaraq dəyişir. Upstream xətalarda yalnız mesaj saxlanılır və təmizlənərək ötürülür; stack və ya daxili sahələr ötürülmür.
OpenAI uyğun yolun mətnidir.
{
"error": {
"message": "API key is required.",
"type": "invalid_request_error"
}
}Anthropic uyğun yolun mətnidir. error.type status kodu ilə müəyyən edilir.
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "..."
},
"request_id": "rqid..."
}| Status 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 |
| Digər kodlar | api_error |
Limitləri və istifadəyə nəzarət
Limit göstəriciləri hər iş sahəsi üçün fərqlidir. 403 səbəbini error.message vasitəsilə yoxladıqdan sonra aşağıdakı ekranda göstəricilərə baxın.
| Yoxlanılacaq | Konsol ekranı |
|---|---|
| İş sahəmə tətbiq olunan limit | İcmaldakı təyin edilmiş istifadə limiti |
| Planın icazə verdiyi aralıq və qalıq | Plan və kreditlər |
| Faktiki istifadə (model və açar üzrə çağırış sayı, təxmini çıxılacaq kreditlər) | İstifadə |
| Açarın vəziyyəti (müddətinin bitib-bitməməsi və ləğv edilib-edilməməsi) | API açarı |