อ่านการตอบกลับทั้งหมด
สำหรับสถานะที่ไม่สำเร็จ ให้เก็บรหัส HTTP ส่วนหัว เนื้อหาข้อผิดพลาด และรหัสคำขอหลังจากนำข้อมูลลับออก ข้อมูลเหล่านี้ช่วยแยกคำขอที่ไม่ถูกต้องออกจากการปฏิเสธการเข้าถึงหรือปัญหาชั่วคราว
อย่าแสดงการตอบกลับดิบของบริการเป็นข้อความเดียวแก่ผู้ใช้ ให้อธิบายการดำเนินการพร้อมเก็บรายละเอียดการวินิจฉัยไว้สำหรับผู้ปฏิบัติงาน
ตรวจสอบการตอบกลับที่ล้มเหลว
bash
curl --include --request POST https://cicora.ai/api/v1/chat/completions \
--header "Authorization: Bearer $CICORA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{"model":"openai/gpt-5.6-sol","messages":[]}'จำแนกความล้มเหลว
- 4xx โดยทั่วไปต้องแก้ไขคีย์ ข้อมูลอินพุต หรือการเข้าถึง
- 429 ต้องเคารพช่วงเวลาของขีดจำกัดและหลีกเลี่ยงการลองใหม่อย่างถี่เกินไป
- ข้อผิดพลาด 5xx และความขัดข้องของเครือข่ายควรลองใหม่ในจำนวนครั้งที่จำกัด โดยใช้การหน่วงเวลาแบบเอ็กซ์โพเนนเชียลและเพิ่มค่าความสุ่ม
ลองใหม่อย่างปลอดภัย
ลองใหม่เฉพาะความล้มเหลวชั่วคราว และเฉพาะเมื่อการดำเนินการเป็นแบบ idempotent ในผลิตภัณฑ์ของคุณ สำหรับการสร้าง ให้เก็บรหัสคำขอฝั่งไคลเอนต์เพื่อป้องกันการเรียกเก็บเงินซ้ำหรืออาร์ติแฟกต์ซ้ำ
ในการสตรีม ให้แยกข้อผิดพลาดก่อนเดลตาแรกออกจากการหยุดชะงักหลังมีเอาต์พุตบางส่วน กรณีหลังไม่สามารถแทนที่ด้วยการตอบกลับใหม่โดยไม่แจ้งให้ทราบ