Developer guide
کۆدی هەڵە
ڕێوشوێنی مامەڵەکردن و یاساکانی دووبارە هەوڵدان بەپێی کۆدی دۆخ
ئەم پەڕەیە کۆدەکانی دۆخ کە گەیتوەی دەگەڕێنێتەوە و مانایان، هەروەها ڕێوشوێنی مامەڵەکردن بەپێی کۆد ڕوون دەکاتەوە.
ئەگەر upstream کۆدی 4xx یان 5xx بدات، هەمان کۆد بەبێ گۆڕان دەگەڕێنینەوە؛ لە حاڵەتەکانی دیکەدا، خشتەی خوارەوە پەیڕەو دەکرێت.
شێوەی دەقی هەڵە بۆ هەردوو ڕێکخستنی هاوگونجاو، یاساکانی Anthropic هاوگونجاو error.type، و شاشەی کۆنسۆڵ بۆ پشکنینی سنوور و بەکارهێنانیش لێرەدا هاتووە.
کۆدی دۆخ
| کۆد | مانا | ڕێوشوێن |
|---|---|---|
| 400 | هەڵەی بەهای داواکاری. limit لە لیستی مۆدێلەکانی Anthropic هاوگونجاو لە 1~1000 دەرچووە، یان هەوڵدراوە وەڵامێکی پاشەکەوتکراو بە GET /responses/{responseId}?stream=true بەردەوام بکرێت | بەهاکە لە سنووری دیاریکراودا ڕێک دەخەین. وەڵامی پاشەکەوتکراو بەبێ stream دەخوێنینەوە. |
| 401 | کلیل نییە، یان کلیلەکە بەسەرچووە یان هەڵوەشێنراوەتەوە | لە پەڕەی کلیلەکانی API دۆخی کلیلەکە پشکنین دەکەین و ناوی هێدەر و پێشگری Bearer دەدۆزینەوە. |
| 403 | دەسەڵاتی دەستگەیشتن بە مۆدێل نییە، سنووری بەکارهێنان تێپەڕێنراوە، کرێدیت کەمە، یان خاوەنی دەنگ نییە | error.message هۆکارەکە جیا دەکاتەوە. ژمارەکان لە شاشەی بەشی سنوور و پشکنینی بەکارهێنانی خوارەوە دەبینرێن. |
| 404 | مۆدێل بوونی نییە یان بەو کلیلە ناتوانرێت دەستی پێ بگات (لەوانەش مۆدێلی کۆتاییپێهاتوو)، ڕێڕەوی بوونی نییە، یان بەرهەمی CleviDrive کە ماوەی پاراستنی 3 ڕۆژی تێپەڕاندووە | سەرەتا لیستی مۆدێلەکانی بانگکردن بە GET /models پشکنین دەکەین. ڕێڕەوەکە لەگەڵ خشتەی پەڕەی بانگکردنی API بەراورد دەکەین. |
| 408 · 409 · 413 | کاتی چاوەڕوانی upstream تێپەڕێنراوە، قەرەباڵغی، یان قەبارەی داواکاری تێپەڕێنراوە. بەپێی ڕێڕەوی دەنگ و voice، کاتی سنووردار 5 خولەکە و سنووری داواکاری 28 MiB ـە | ئەگەر 409 ـدا Retry-After هەبێت، بەو ماوەیە چاوەڕێ دەکەین. بۆ 413 داواکارییەکە دابەش دەکەین و دەنێرین. |
| 429 | کاتێک دابینکەری upstream سنووری خێرایی داناوە | ئەگەر Retry-After هەبوو، هەمان پەیڕەو دەکەین؛ ئەگەر نەبوو، بە زیادبوونی ئێکسپۆنێنشیاڵ دووبارە هەوڵ دەدەین. |
| 5xx | هەڵەی کاتیی گەیتوەی یان upstream (لەوانەش 503) | بە زیادبوونی ئێکسپۆنێنشیاڵ دووبارە هەوڵ دەدەین. ئەگەر دووبارە بووەوە، لەگەڵ X-Request-Id لە ڕێگەی بەشی یارمەتی و پەیوەندیکردن ئاگادارمان بکەنەوە. |
دووبارە هەوڵدان
گەیتوەی خۆی 429 دروست ناکات، و وەڵامی upstream بە نهێنی دووبارە هەوڵ نادات یان لە ڕیزی چاوەڕوانی دای نەنێت.
چاوەڕوانبوون و دووبارە هەوڵدان لەلایەن کلایەنتەوە ئەنجام دەدرێت.
| کۆد | کاتی چاوەڕوانی | دواتر |
|---|---|---|
| 409 | ئەگەر Retry-After هەبێت، بۆ ئەو ماوەیە | هەمان داواکاری دووبارە دەنێرین. |
| 429 | ئەگەر Retry-After هەبێت، بۆ ئەو ماوەیە؛ ئەگەر نەبێت، پاشەکشەی ئەسیی | هەمان داواکاری دووبارە دەنێرین. |
| 5xx | پاشەکشەی ئەسیی | ئەگەر دووبارە بووەوە، پەیوەندیمان پێوە بکەن. |
| 413 | بێ چاوەڕوانی | داواکارییەکە دابەش دەکەین. |
ناوەڕۆکی هەڵە
شێوەی ناوەڕۆکی هەڵە بەپێی ستانداردەکە جیاوازە. هەڵەکانی سەرەوە تەنها بە پەیامەکەیان دەهێڵینەوە و ڕێکیان دەخەین؛ ستاک یان خانە ناوخۆییەکان نانێردرێن.
ئەمە ناوەڕۆکی ڕێڕەوی گونجاو لەگەڵ OpenAI ـە.
{
"error": {
"message": "API key is required.",
"type": "invalid_request_error"
}
}ئەمە ناوەڕۆکی ڕێڕەوی گونجاو لەگەڵ Anthropic ـە. error.type بە کۆدی دۆخەکە دیاری دەکرێت.
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "..."
},
"request_id": "rqid..."
}| کۆدی دۆخ | 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 |
| کۆدەکانی تر | api_error |
پشکنینی سنوور و بەکارهێنان
ژمارەکانی سنوور بەپێی وۆرکسپەیس جیاوازن. دوای پشکنینی هۆکاری 403 لە error.message، ژمارەکان لە شاشەکانی خوارەوە ببینن.
| ئەوەی بپشکنرێت | شاشەی کۆنسۆڵ |
|---|---|
| سنووری دانراو بۆ وۆرکسپەیسی من | سنووری بەکارهێنانی دیاریکراو لە پوختە |
| مەودای ڕێگەپێدراو لەلایەن پلانەکە و باڵانس | پلان و کرێدیت |
| بەکارهێنانی ڕاستەقینە (ژمارەی بانگهێشتەکان بەپێی مۆدێل و کلیل، کرێدیتی خەمڵێنراوی کەمکراوە) | بەکارهێنان |
| دۆخی کلیل (بەسەرچوون یان هەڵوەشاندنەوەی) | کلیلەکانی API |