Developer guide

ລະຫັດຂໍ້ຜິດພາດ

ວິທີຈັດການຕາມລະຫັດສະຖານະ ແລະກົດການລອງໃໝ່

ໜ້ານີ້ສະຫຼຸບລະຫັດສະຖານະທີ່ເກດເວຍສົ່ງກັບ, ຄວາມໝາຍຂອງລະຫັດ, ແລະວິທີຈັດການຕາມແຕ່ລະລະຫັດ.
ຖ້າອັບສະຕຣີມໃຫ້ລະຫັດ 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	ໝົດເວລາຂອງອັບສະຕຣີມ, ການແອອັດ, ຫຼືຂະໜາດຄຳຂໍເກີນ. ສຳລັບເສັ້ນທາງສຽງ·ວອຍສ໌ ເວລາຈຳກັດແມ່ນ 5 ນາທີ ແລະຂີດຈຳກັດຄຳຂໍແມ່ນ 28 MiB	ຖ້າ 409 ມີ Retry-After ໃຫ້ລໍຖ້າຕາມເວລານັ້ນ. ສຳລັບ 413 ໃຫ້ແບ່ງຄຳຂໍແລ້ວສົ່ງ.
429	ຜູ້ໃຫ້ບໍລິການອັບສະຕຣີມຈຳກັດຄວາມໄວ	ຖ້າມີ Retry-After ໃຫ້ປະຕິບັດຕາມໂດຍກົງ, ຖ້າບໍ່ມີ ໃຫ້ລອງໃໝ່ດ້ວຍ exponential backoff.
5xx	ຂໍ້ຜິດພາດຊົ່ວຄາວຂອງເກດເວຍ ຫຼືອັບສະຕຣີມ (ລວມເຖິງ 503)	ໃຫ້ລອງໃໝ່ດ້ວຍ exponential backoff. ຖ້າເກີດຊ້ຳ ໃຫ້ແຈ້ງຜ່ານສູນຊ່ວຍເຫຼືອ ແລະການຕິດຕໍ່ ພ້ອມ X-Request-Id.

ການລອງໃໝ່

ເກດເວຍຈະບໍ່ສ້າງ 429 ຂອງຕົນເອງ, ບໍ່ລອງໃໝ່ຄຳຕອບຈາກອັບສະຕຣີມຢ່າງລັບໆ ແລະບໍ່ນຳໄປເຂົ້າຄິວ.
ລູກຄ້າເປັນຜູ້ລໍຖ້າ ແລະລອງໃໝ່.

ລະຫັດ	ເວລາລໍຖ້າ	ຈາກນັ້ນ
409	ຖ້າມີ Retry-After ໃຫ້ລໍຖ້າຕາມເວລານັ້ນ	ສົ່ງຄຳຂໍເດີມອີກຄັ້ງ.
429	ຖ້າມີ Retry-After ໃຫ້ລໍຖ້າຕາມເວລານັ້ນ, ຖ້າບໍ່ມີໃຫ້ໃຊ້ exponential backoff	ສົ່ງຄຳຂໍເດີມອີກຄັ້ງ.
5xx	exponential backoff	ຖ້າເກີດຊ້ຳ ໃຫ້ຕິດຕໍ່ສອບຖາມ.
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

ກວດເບິ່ງຂີດຈຳກັດແລະການນຳໃຊ້

ຕົວເລກຂີດຈຳກັດແຕກຕ່າງກັນໄປຕາມແຕ່ລະ workspace. ກວດເບິ່ງເຫດຜົນຂອງ 403 ຜ່ານ error.message ແລ້ວເບິ່ງຕົວເລກໃນໜ້າຈໍດ້ານລຸ່ມ.

ສິ່ງທີ່ຕ້ອງກວດເບິ່ງ	ໜ້າຈໍຄອນໂຊນ
ຂີດຈຳກັດທີ່ນຳໃຊ້ກັບ workspace ຂອງຂ້ອຍ	ຂີດຈຳກັດການນຳໃຊ້ທີ່ຈັດສັນໃນພາບລວມ
ຂອບເຂດແລະຍອດຄົງເຫຼືອທີ່ແຜນອະນຸຍາດ	ແຜນແລະເຄຣດິດ
ການນຳໃຊ້ຈິງ (ຈຳນວນການເອີ້ນໃຊ້ຕາມໂມເດວລແລະຕາມຄີ, ເຄຣດິດທີ່ຄາດວ່າຈະຫັກ)	ການນຳໃຊ້
ສະຖານະຂອງຄີ (ໝົດອາຍຸ ຫຼືຖືກຍົກເລີກຫຼືບໍ່)	API key

ລະຫັດຂໍ້ຜິດພາດ

ລະຫັດສະຖານະ

ການລອງໃໝ່

ເນື້ອໃນຂໍ້ຜິດພາດ

ກວດເບິ່ງຂີດຈຳກັດແລະການນຳໃຊ້

ພາສາ ແລະ ພາກພື້ນ

ແນະນຳ

ອາຊີຕາເວັນອອກ

ອາຊີຕາເວັນອອກສຽງໃຕ້

ອາຊີໃຕ້

ອາຊີກາງ

ຕາເວັນອອກກາງ ແລະ ຄໍເຄຊັດ

ຢູໂຣບຕາເວັນຕົກ ແລະ ຢູໂຣບໃຕ້

ສະຫະລາດຊະອະນາຈັກ ແລະ ໄອແລນ

ຢູໂຣບເໜືອ

ເອີຣົບກາງ ແລະ ບານຄານ

ຢູໂຣບຕາເວັນອອກ

ອາຟຣິກາຕາເວັນອອກ

ອາຟຣິກາຕາເວັນຕົກ ແລະ ອາຟຣິກາກາງ

ອາຟຣິກາຕອນໃຕ້

ອາເມຣິກາ

ໂອຊີອານີ