ข้อผิดพลาด ข้อจำกัด และการลองใหม่

API ของ Felo ทุกตัวส่งเนื้อหาข้อผิดพลาดแบบ JSON พร้อมรหัสข้อผิดพลาดที่คงที่และ request ID ให้อ่านสถานะ HTTP ก่อน จากนั้นอ่าน code แล้วจึงอ่าน message

ซองข้อผิดพลาด

การตอบกลับในโปรดักชันปัจจุบันใช้สถานะ HTTP เป็น status:

{
  "status": 401,
  "code": "UNAUTHORIZED",
  "message": "Invalid API Key",
  "request_id": "202610221444486982113280416060637185"
}

ตัวอย่าง endpoint รุ่นเก่าบางส่วนใช้ status: "error" และสตริงรหัสที่แตกต่างออกไป ให้แยกการทำงานตามสถานะ HTTP และ code ไม่ใช่ตามถ้อยคำที่แน่นอนของ message

รหัสที่พบบ่อย

เอกสารอ้างอิงของแต่ละ endpoint จะระบุรหัสที่เฉพาะกับ endpoint นั้น เริ่มจากข้อผิดพลาดของ Chat APIหรือเอกสารอ้างอิงของ endpoint ที่คุณกำลังเรียก

Endpoint การสร้างด้วยโมเดล

POST /api/v1/images/generations และ POST /api/v1/videos/generations ส่งข้อผิดพลาดระดับ endpoint ในซองแบบ OpenAI แทนซองข้างต้น:

{
  "error": {
    "message": "Model kind does not match this generation endpoint",
    "type": "invalid_request_error",
    "param": null,
    "code": "model_kind_mismatch"
  }
}

request ID อยู่ใน header การตอบกลับ X-Request-Id ไม่ได้อยู่ในเนื้อหาการตอบกลับ คำขอที่ถูกปฏิเสธจะไม่สร้างงาน เมื่อมีงานอยู่แล้ว ความล้มเหลวส่วนใหญ่จะมาในรูปสถานะสิ้นสุดของงานในการตอบกลับ 200 แทนที่จะเป็นข้อผิดพลาด HTTP ให้ตรวจสอบ status ว่าเป็น failed หรือ interrupted แล้วอ่าน error.message ดูการสร้างรูปภาพและงานอะซิงโครนัส

Request ID

เนื้อหาข้อผิดพลาดของ Felo มี request_id ให้บันทึกไว้พร้อม endpoint สถานะ HTTP รหัสข้อผิดพลาด ID โมเดล และ ID งาน ห้ามบันทึกคีย์ API แบบเต็ม

Model API ยังยอมรับ header คำขอ X-Request-Id แบบเลือกได้ เมื่อคุณส่งมา ระบบจะสะท้อนกลับเพื่อการวินิจฉัย ซึ่งช่วยให้เชื่อมโยงล็อกของคุณกับคำขอได้ หากคุณไม่ได้ส่งมา ให้ใช้ request_id ที่ส่งกลับ

ขีดจำกัดอัตรา

/v2/chat เป็น endpoint เดียวของ Felo ที่มีขีดจำกัดอัตราที่บังคับใช้และจัดทำเอกสารไว้:

• ต่อคีย์ API หน้าต่าง 1 นาที
• ต่อผู้ใช้ หน้าต่าง 1 นาที
• ต่อผู้ใช้ หน้าต่าง 1 ชั่วโมง

ผู้ใช้ที่มีการสมัครสมาชิก Felo แบบชำระเงินที่ใช้งานได้ รวมถึงการสมัครสมาชิกองค์กร จะได้รับการยกเว้นและไม่ได้รับ header X-RateLimit-* หากไม่สามารถตรวจสอบสถานะการสมัครสมาชิกได้ ขีดจำกัดยังคงมีผล

endpoint /v2/** อื่น ๆ ในปัจจุบันไม่มีขีดจำกัดอัตราที่บังคับใช้ คำขอ Model API ยังอาจถูกจำกัดโดยผู้ให้บริการต้นทาง ซึ่งอาจปรากฏเป็น 429 ได้

ห้ามฝังขีดจำกัดเชิงตัวเลขแบบตายตัว ให้อ่าน header ในการตอบกลับแต่ละครั้ง

นโยบายการลองใหม่

ลูปที่แนะนำ:

1. ลองใหม่เฉพาะคำขอที่ทำซ้ำได้หรือปลอดภัยต่อการทำซ้ำ
2. ใช้การหน่วงแบบทวีคูณ: เริ่มประมาณ 1 วินาที เพิ่มเป็นสองเท่า และกำหนดเพดานที่ 30 วินาที
3. เพิ่ม jitter แบบสุ่มเพื่อไม่ให้ไคลเอนต์ลองใหม่พร้อมกัน
4. หยุดหลังจากพยายามไม่กี่ครั้งแล้วแสดงข้อผิดพลาด
5. เมื่อได้รับ 429 ให้ปฏิบัติตาม Retry-After แทนกำหนดการของคุณเอง

ลำดับการแก้ไขข้อบกพร่อง

1. ตรวจสอบว่ามีคีย์และยังไม่ถูกเพิกถอน
2. เรียก GET /api/v1/models ด้วยคีย์เดียวกันเพื่อยืนยันการรับรองความถูกต้อง
3. ส่งคำขอที่ถูกต้องและเล็กที่สุดไปยัง endpoint เป้าหมาย
4. เพิ่มสตรีมมิ่ง เครื่องมือ หรืออินพุตขนาดใหญ่ทีละอย่าง
5. สำหรับงานอะซิงโครนัส ให้ตรวจสอบสถานะงานก่อนส่งคำขอใหม่

เนื้อหาที่เกี่ยวข้อง

• การรับรองความถูกต้อง
• ช่องทางและการกำหนดเส้นทางผู้ให้บริการ
• งานอะซิงโครนัส
• การแก้ไขปัญหา