Skip to content

รหัสสถานะ

เอนด์พอยต์จะส่งคืนรหัสสถานะ HTTP ที่เหมาะสมตามความสำเร็จหรือล้มเหลวของคำขอในบรรทัดสถานะ HTTP (เช่น HTTP/1.1 200 OK หรือ HTTP/1.1 400 Bad Request) รหัสสถานะที่พบบ่อยคือ:

  • 200: สำเร็จ
  • 400: คำขอไม่ถูกต้อง (พารามิเตอร์หายไป, JSON ไม่ถูกต้อง ฯลฯ)
  • 404: ไม่พบ (โมเดลไม่มีอยู่ ฯลฯ)
  • 429: คำขอมากเกินไป (เช่น เมื่อเกินขีดจำกัดอัตราการเรียกใช้)
  • 500: ข้อผิดพลาดภายในเซิร์ฟเวอร์
  • 502: เกตเวย์ไม่ถูกต้อง (เช่น เมื่อไม่สามารถเข้าถึงโมเดลบนคลาวด์ได้)

ข้อความข้อผิดพลาด

ข้อผิดพลาดจะถูกส่งคืนในรูปแบบ application/json ด้วยโครงสร้างดังต่อไปนี้ โดยมีข้อความข้อผิดพลาดอยู่ในคุณสมบัติ error:

json
{
  "error": "the model failed to generate a response"
}

ข้อผิดพลาดที่เกิดขึ้นระหว่างสตรีมมิ่ง

หากเกิดข้อผิดพลาดระหว่างสตรีมมิ่ง ข้อผิดพลาดจะถูกส่งคืนเป็นออบเจ็กต์ในรูปแบบ application/x-ndjson พร้อมคุณสมบัติ error เนื่องจากคำตอบได้เริ่มส่งออกแล้ว รหัสสถานะของคำตอบจะไม่ถูกเปลี่ยนแปลง

json
{"model":"gemma4","created_at":"2025-10-26T17:21:21.196249Z","response":" Yes","done":false}
{"model":"gemma4","created_at":"2025-10-26T17:21:21.207235Z","response":".","done":false}
{"model":"gemma4","created_at":"2025-10-26T17:21:21.219166Z","response":"I","done":false}
{"model":"gemma4","created_at":"2025-10-26T17:21:21.231094Z","response":"can","done":false}
{"error":"an error was encountered while running the model"}