Developer guide
Алдааны код
Төлөвийн код бүрд авах арга хэмжээ ба дахин оролдох дүрэм
Энэ хуудсанд гарцын буцаадаг төлөвийн кодууд, тэдгээрийн утга болон код бүрд авах арга хэмжээг нэгтгэн харуулав.
Дээд талын үйлчилгээ 4xx·5xx буцаавал тухайн кодыг өөрчлөлгүй дамжуулж, бусад тохиолдолд доорх хүснэгтийг дагана.
Мөн хоёр нийцтэй стандартын алдааны үндсэн бүтэц, Anthropic-тэй нийцтэй error.type-ийн дүрэм, хязгаар болон хэрэглээг шалгах консолын дэлгэцийг тайлбарласан.
Төлөвийн код
| Код | Утга | Авах арга хэмжээ |
|---|---|---|
| 400 | Хүсэлтийн утга буруу. Anthropic-тэй нийцтэй загварын жагсаалтын limit нь 1~1000-ийн хүрээнээс хэтэрсэн эсвэл GET /responses/{responseId}?stream=true ашиглан хадгалсан хариуг үргэлжлүүлэн авахыг оролдсон | Утгыг зөвшөөрөгдсөн хүрээнд оруулна. Хадгалсан хариуг stream-гүйгээр авна. |
| 401 | Түлхүүр байхгүй, хугацаа нь дууссан эсвэл хүчингүй болсон | API түлхүүрийн хуудсанд түлхүүрийн төлөвийг шалгаж, толгойн нэр болон Bearer угтварыг нягтална. |
| 403 | Загварт хандах эрхгүй, ашиглалтын хязгаараас хэтэрсэн, кредит хүрэлцэхгүй эсвэл voice-ийн эзэмшигч биш | error.message нь шалтгааныг ялгаж харуулна. Тоон утгыг доорх хязгаар ба ашиглалт шалгах хэсгийн дэлгэцээс харна. |
| 404 | Загвар байхгүй эсвэл энэ түлхүүрээр хандах боломжгүй (дэмжлэг нь дууссан загваруудыг оролцуулна), зам байхгүй, эсвэл хадгалах 3 өдрийн хугацаа өнгөрсөн CleviDrive-ийн гаралт | Эхлээд 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-тэй нийцтэй замын үндсэн хэсэг.
{
"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 түлхүүр |