Developer guide

የስህተት ኮድ

በሁኔታ ኮድ መሠረት የሚደረግ እርምጃ እና የድጋሚ ሙከራ ደንቦች

ይህ ገጽ ጌትዌዩ የሚመልሳቸውን የሁኔታ ኮዶችና ትርጉማቸውን፣ እንዲሁም በእያንዳንዱ ኮድ ላይ የሚደረገውን እርምጃ ያጠቃልላል።
አፕስትሪም 4xx·5xx ከሰጠ ኮዱን እንዳለ እናስተላልፋለን፤ በሌሎች ሁኔታዎች ደግሞ ከታች ያለውን ሰንጠረዥ እንከተላለን።
የሁለቱ ተኳሃኝ ዝርዝሮች የስህተት አካል ቅርጾችንና የAnthropic ተኳሃኝ error.type ደንቦችን፣ እንዲሁም ገደቦችንና አጠቃቀምን የሚመለከቱበትን የኮንሶል ገጽ አካተናል።

የሁኔታ ኮድ

ኮድ	ትርጉም	እርምጃ
400	የጥያቄ እሴት ስህተት። በAnthropic ተኳሃኝ የሞዴል ዝርዝር ውስጥ limit ከ1~1000 ውጭ ከሆነ፣ ወይም GET /responses/{responseId}?stream=true በመጠቀም የተቀመጠ ምላሽን ለመቀጠል ከሞከሩ	እሴቱን በተፈቀደው ክልል ውስጥ ያስተካክሉ። የተቀመጠውን ምላሽ stream ሳይጠቀሙ ይመልከቱ።
401	ቁልፍ የለም፣ ወይም ቁልፉ ጊዜው አልፎበታል ወይም ተሰርዟል	በAPI ቁልፍ ገጽ ላይ የቁልፉን ሁኔታ ያረጋግጡ፤ የራስጌውን ስምና Bearer ቅድመ ቅጥያ ይመርምሩ።
403	የሞዴል መዳረሻ ፈቃድ የለም፣ የአጠቃቀም ገደብ ተሻግሯል፣ ክሬዲት በቂ አይደለም፣ ወይም የድምፅ ባለቤት አይደሉም	error.message ምክንያቱን ይለያል። መጠኖቹን ከታች ባለው የገደብና የአጠቃቀም ማረጋገጫ ክፍል ገጽ ላይ ይመልከቱ።
404	ሞዴሉ የለም ወይም በዚህ ቁልፍ መድረስ አይቻልም (ድጋፉ ያበቃላቸው ሞዴሎችን ጨምሮ)፣ መንገዱ የለም፣ ወይም የCleviDrive ውጤት የማቆያ ጊዜው 3 ቀን አልፏል	በመጀመሪያ GET /models በመጠቀም ሊጠሩ የሚችሉ ሞዴሎችን ይመልከቱ። መንገዱን በAPI መጠሪያ ገጽ ላይ ካለው ሰንጠረዥ ጋር ያወዳድሩ።
408 · 409 · 413	የአፕስትሪም ጊዜ ማብቂያ፣ መጨናነቅ፣ ወይም የጥያቄ መጠን መብለጥ። ለድምፅ·voice መንገዶች የጊዜ ገደቡ 5 ደቂቃ ሲሆን፣ የጥያቄ ከፍተኛ መጠኑ 28 MiB ነው	409 ላይ Retry-After ካለ በዚያ ጊዜ መጠን ይጠብቁ። 413 ከሆነ ጥያቄውን ከፋፍለው ይላኩ።
429	አፕስትሪም አቅራቢው የፍጥነት ገደብ ሲጥል	Retry-After ካለ እንዳለ ይከተሉ፤ ከሌለ በኤክስፖኔንሻል ባክኦፍ ድጋሚ ይሞክሩ።
5xx	የጌትዌይ ወይም የአፕስትሪም ጊዜያዊ ስህተት (503ን ጨምሮ)	በኤክስፖኔንሻል ባክኦፍ ድጋሚ ይሞክሩ። ችግሩ ከተደጋገመ ከX-Request-Id ጋር በእገዛና በግንኙነት ቻናሎች ያሳውቁን።

ድጋሚ ሙከራ

ጌትዌዩ የራሱን 429 አያመነጭም፤ እንዲሁም የአፕስትሪም ምላሽን በድብቅ ዳግም አይሞክርም ወይም ወረፋ ውስጥ አያስገባም።
መጠበቅና ድጋሚ መሞከር የደንበኛው ኃላፊነት ነው።

ኮድ	የመጠበቂያ ጊዜ	ከዚያ
409	Retry-After ካለ፣ ያንን ጊዜ	ተመሳሳይ ጥያቄን እንደገና ይልካሉ።
429	Retry-After ካለ፣ ያንን ጊዜ፤ ከሌለ ግን ኤክስፖኔንሻል ባክኦፍ	ተመሳሳይ ጥያቄን እንደገና ይልካሉ።
5xx	ኤክስፖኔንሻል ባክኦፍ	ከተደጋገመ ያግኙን።
413	መጠበቅ የለም	ጥያቄውን ይከፋፍላሉ።

የስህተት አካል

የስህተት አካሉ እንደ ዝርዝሩ መስፈርት ይለያያል። የአፕስትሪም ስህተቶችን መልዕክቱን ብቻ በማስቀረት አጽድተን እናስተላልፋለን፤ ስታክ ወይም የውስጥ መስኮች አይተላለፉም።

ይህ የ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 ካረጋገጡ በኋላ፣ ከታች ባለው ማያ ገጽ ላይ መጠኖቹን ይመልከቱ።

ማረጋገጥ ያለበት	የኮንሶል ማያ ገጽ
በእኔ የስራ ቦታ ላይ የተጣለው ገደብ	በአጠቃላይ እይታ ያለው የተመደበ የአጠቃቀም ገደብ
በፕላኑ የሚፈቀደው ክልል እና ቀሪ ሂሳብ	ፕላን እና ክሬዲት
ትክክለኛ አጠቃቀም (በሞዴል እና በቁልፍ የሚለያዩ የጥሪ መጠኖች፣ የሚጠበቀው የሚቀነስ ክሬዲት)	አጠቃቀም
የቁልፉ ሁኔታ (ጊዜው አልፎበት ወይም ተሰርዞ እንደሆነ)	API ቁልፍ

የስህተት ኮድ

የሁኔታ ኮድ

ድጋሚ ሙከራ

የስህተት አካል

ገደቦችን እና አጠቃቀምን ያረጋግጡ

ቋንቋ እና ክልል

የሚመከር

ምስራቃዊ እስያ

ደቡብ ምስራቅ እስያ

ደቡባዊ እስያ

መካከለኛው እስያ

መካከለኛው ምስራቅ እና ካውካሰስ

ምዕራብ አውሮፓ እና ደቡባዊ አውሮፓ

ዩናይትድ ኪንግደም እና አየርላንድ

ሰሜናዊ አውሮፓ

መካከለኛው አውሮፓ እና ባልካን

ምስራቅ አውሮፓ

ምስራቅ አፍሪካ

ምዕራባዊ አፍሪካ እና መካከለኛው አፍሪካ

ደቡባዊ አፍሪካ

አሜሪካ

ኦሺያንያ