Developer guide

Սխալի կոդ

Գործողություններ և վերափորձման կանոններ՝ ըստ կարգավիճակի կոդի

Այս էջում ամփոփված են դարպասի կողմից վերադարձվող կարգավիճակի կոդերը, դրանց նշանակությունը և յուրաքանչյուր կոդի դեպքում կատարվող գործողությունները։
Եթե upstream-ը վերադարձնում է 4xx կամ 5xx, այդ կոդը փոխանցվում է 그대로, իսկ մյուս դեպքերում կիրառվում է ստորև ներկայացված աղյուսակը։
Ներկայացված են նաև երկու համատեղելի ստանդարտների սխալի մարմնի ձևաչափը, Anthropic-ի հետ համատեղելի error.type-ի կանոնները և սահմանաչափերն ու օգտագործումը ստուգելու վահանակի էկրանը։

Կարգավիճակի կոդ

Կոդ	Նշանակություն	Գործողություն
400	Հարցման արժեքի սխալ։ Anthropic-ի հետ համատեղելի մոդելների ցանկի limit-ը դուրս է 1~1000 միջակայքից, կամ փորձ է արվել շարունակել պահպանված պատասխանը GET /responses/{responseId}?stream=true-ի միջոցով	Արժեքը փոխեք թույլատրելի միջակայքի։ Պահպանված պատասխանը ստացեք առանց stream-ի։
401	Բանալին բացակայում է կամ ժամկետանց/չեղարկված է	API key-ի էկրանին ստուգեք բանալու կարգավիճակը և ստուգեք վերնագրի անունն ու Bearer նախածանցը։
403	Մոդելի հասանելիության թույլտվություն չկա, օգտագործման սահմանաչափը գերազանցված է, կրեդիտը բավարար չէ, կամ դուք voice-ի սեփականատերը չեք	error.message-ը տարբերակում է պատճառները։ Թվերը դիտեք ստորև ներկայացված սահմանաչափերի և օգտագործման ստուգման բաժնի էկրանին։
404	Մոդելը գոյություն չունի կամ հասանելի չէ այս բանալիով (ներառյալ այն մոդելները, որոնց աջակցությունն ավարտվել է), ուղին գոյություն չունի, կամ CleviDrive-ի արդյունքի պահպանման 3-օրյա ժամկետն անցել է	Սկզբում GET /models-ով ստուգեք կանչելի մոդելների ցանկը։ Ուղին համեմատեք API կանչելու էջի աղյուսակի հետ։
408 · 409 · 413	Upstream-ի ժամանակի սպառում, գերբեռնվածություն կամ հարցման չափի գերազանցում։ Ձայնի և voice-ի ուղիների համար սահմանված ժամանակը 5 րոպե է, իսկ հարցման առավելագույն չափը՝ 28 MiB	Եթե 409 պատասխանում կա Retry-After, սպասեք նշված ժամանակի չափով։ 413-ի դեպքում հարցումը բաժանեք մասերի։
429	Upstream մատակարարը արագության սահմանափակում է կիրառել	Եթե կա Retry-After, հետևեք դրան 그대로, իսկ դրա բացակայության դեպքում վերափորձեք էքսպոնենցիալ backoff-ով։
5xx	Դարպասի կամ upstream-ի ժամանակավոր սխալ (ներառյալ 503-ը)	Վերափորձեք էքսպոնենցիալ backoff-ով։ Եթե կրկնվում է, տեղեկացրեք օգնության և կապի միջոցով՝ նշելով X-Request-Id-ը։

Վերափորձում

Դարպասը ինքնուրույն 429 չի ստեղծում և upstream-ի պատասխանները գաղտնի կերպով չի վերափորձում կամ հերթի մեջ չի դնում։
Սպասումն ու վերափորձումը կատարում է հաճախորդը։

Կոդ	Սպասման ժամանակ	Այնուհետև
409	Եթե կա Retry-After, սպասեք այդ ժամանակը	Կրկին ուղարկեք նույն հարցումը։
429	Եթե կա Retry-After, սպասեք այդ ժամանակը, իսկ եթե չկա՝ կիրառեք էքսպոնենցիալ հետաձգում	Կրկին ուղարկեք նույն հարցումը։
5xx	Էքսպոնենցիալ հետաձգում	Եթե կրկնվում է, դիմեք աջակցության։
413	Սպասում պետք չէ	Բաժանեք հարցումը մասերի։

Սխալի մարմին

Սխալի մարմնի ձևաչափը տարբերվում է՝ կախված սպեցիֆիկացիայից։ Վերահոսքային սխալների դեպքում փոխանցվում է միայն հաղորդագրությունը՝ մշակված ձևով, իսկ stack-ը կամ ներքին դաշտերը չեն փոխանցվում։

OpenAI-ին համատեղելի ուղու մարմինն է։

JSON

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

Anthropic-ին համատեղելի ուղու մարմինն է։ error.type-ը որոշվում է կարգավիճակի կոդով։

JSON

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "..."
  },
  "request_id": "rqid..."
}

Anthropic-ին համատեղելի error.type

Կարգավիճակի կոդ	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-ում, ապա ստորև նշված էկրաններում դիտեք սահմանաչափերը։

Ինչ ստուգել	Վահանակի էկրան
Իմ աշխատանքային տարածքի սահմանաչափը	Overview-ի հատկացված օգտագործման սահմանաչափ
Պլանի թույլատրած շրջանակն ու մնացորդը	Պլան և կրեդիտներ
Փաստացի օգտագործումը (ըստ մոդելի և բանալու կանչերի քանակը, ակնկալվող նվազեցվող կրեդիտները)	Օգտագործում
Բանալու կարգավիճակը (ժամկետանց կամ չեղարկված լինելը)	API բանալիներ

Սխալի կոդ

Կարգավիճակի կոդ

Վերափորձում

Սխալի մարմին

Ստուգել սահմանաչափերն ու օգտագործումը

Լեզու և տարածաշրջան

Առաջարկվում է

Արևելյան Ասիա

Հարավարևելյան Ասիա

Հարավային Ասիա

Կենտրոնական Ասիա

Մերձավոր Արևելք և Կովկաս

Արևմտյան Եվրոպա և Հարավային Եվրոպա

Միացյալ Թագավորություն և Իռլանդիա

Հյուսիսային Եվրոպա

Կենտրոնական Եվրոպա և Բալկաններ

Արևելյան Եվրոպա

Արևելյան Աֆրիկա

Արևմտյան Աֆրիկա և Կենտրոնական Աֆրիկա

Հարավային Աֆրիկա

Ամերիկա

Օվկիանիա