Developer guide

کۆدی هەڵە

ڕێوشوێنی مامەڵەکردن و یاساکانی دووبارە هەوڵدان بەپێی کۆدی دۆخ

ئەم پەڕەیە کۆدەکانی دۆخ کە گەیت‌وەی دەیگەڕێنێتەوە، ماناکانیان و ڕێوشوێنی مامەڵەکردن بەپێی کۆد ڕوون دەکاتەوە.
ئەگەر upstream کۆدی 4xx·5xx بدات، هەمان کۆد بەبێ گۆڕان دەگوازینەوە، و لە حاڵەتەکانی تردا خشتەی خوارەوە پەیڕەو دەکەین.
شێوەی ناوەڕۆکی هەڵە لە دوو ڕێکخستنی گونجاو، یاساکانی error.type ـی گونجاو لەگەڵ Anthropic، و شاشەی کۆنسۆڵ بۆ پشکنینی سنوور و بەکارهێنانیش لێرەدا باس کراون.

کۆدی دۆخ

کۆدماناڕێوشوێن
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 تێپەڕیوە، قەرەباڵغی، یان قەبارەی داواکاری زۆرە. کاتی سنووردار بەپێی ڕێڕەوی دەنگ·بەردەنگ 5 خولەکە، و سنووری داواکاری 28 MiB ـەئەگەر لە 409 ـدا Retry-After هەبێت، بەو ماوەیە چاوەڕێ دەکەین. بۆ 413 داواکارییەکە دابەش دەکەین و دەنێرین.
429کاتێک دابینکەری upstream سنووری خێرایی داناوەئەگەر Retry-After هەبوو، هەمان کات پەیڕەو دەکەین؛ ئەگەر نەبوو، بە زیادبوونی ئاسیایی دووبارە هەوڵ دەدەین.
5xxهەڵەی کاتی گەیت‌وەی یان upstream (لەوانەش 503)بە زیادبوونی ئاسیایی دووبارە هەوڵ دەدەین. ئەگەر دووبارە بووەوە، لەگەڵ X-Request-Id لە ڕێنمایی و پەیوەندیکردن ئاگادارمان بکەنەوە.

دووبارە هەوڵدان

گەیت‌وەی 429 ـی خۆی دروست ناکات و وەڵامی upstream بە نهێنی دووبارە هەوڵ نادات یان لە ڕیزدا داینانێت.
چاوەڕوانی و دووبارە هەوڵدان لەلایەن کڕیارەوە دەکرێت.

KodDemê li bendê manêPaşê
409Heke Retry-After hebe, ew demDîsa heman daxwazê bişînin.
429Heke Retry-After hebe, ew dem; heke tune be, paşveçûna eksponansîyelDîsa heman daxwazê bişînin.
5xxPaşveçûna eksponansîyelHeke dubare bibe, pêwendî bikin.
413Bê rawestanDaxwazê parçe bikin û bişînin.

Naveroka çewtiyê

Naveroka çewtiyê li gorî taybetmendiyê şeklên cuda hene. Çewtiyên upstream tenê bi peyamê dihêlin û bi rêkûpêk radigihînin; stack an jî qadên hundirîn nayên şandin.

Ev naveroka rêça bi OpenAI re hevaheng e.

{
  "error": {
    "message": "API key is required.",
    "type": "invalid_request_error"
  }
}

Ev naveroka rêça bi Anthropic re hevaheng e. error.type bi koda rewşê tê diyarkirin.

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "..."
  },
  "request_id": "rqid..."
}
Anthropic re hevaheng error.type
Koda rewşêerror.type
400invalid_request_error
401authentication_error
403permission_error
404not_found_error
413request_too_large
429rate_limit_error
529overloaded_error
Kodên dinapi_error

Kontrolkirina sînor û bikaranînê

Hejmarên sînorê li gorî workspaceê diguherin. Sedema 403 di error.message de kontrol bikin, paşê hejmaran di ekranên jêrîn de bibînin.

Tiştên ku bên kontrolkirinEkrana konsolê
Sînorê ku li ser workspace-a min hatiye danînSînorê bikaranînê yê veqetandî di Kurteçavê de
Qada ku plan destûrê dide û balansa mayîPlan û kredît
Bikaranîna rastîn (hejmara bangên li gorî model û kilîtan, kredîtên ku tê texmînkirin ku bêne kêmkirin)Bikaranîn
Rewşa kilîtê (dawîbûn an betalkirin)Kilîtên API
CLEVI

Ziman û herêm

Zimanên bi wergera makîneyê hatine wergerandin hatine nîşankirin. Berdestbûn li gorî pakêta malperê ya weşandî ye.

136 ziman

Pêşniyarkirî

1

Rojhilatê Asyayê

7

Başûrrojhilatê Asyayê

11

Başûrê Asyayê

18

Asyaya Navîn

5

Rojhilata Navîn û Kafkasya

10

Rojavayê Ewropayê û Başûrê Ewropayê

16

Qiralîyeta Yekbûyî û Îrlanda

4

Bakurê Ewropayê

10

Ewropaya Navîn û Balkan

14

Rojhilatê Ewropayê

5

Rojhilatê Afrîkayê

8

Rojavayê Afrîkayê û Afrîkaya Navîn

9

Başûrê Afrîkayê

8

Amerîka

5

Okyanûsya

5