Mã trạng thái

Các điểm cuối trả về mã trạng thái HTTP phù hợp dựa trên thành công hay thất bại của yêu cầu trong dòng trạng thái HTTP (ví dụ: HTTP/1.1 200 OK hoặc HTTP/1.1 400 Bad Request). Các mã trạng thái phổ biến là:

• 200: Thành công
• 400: Yêu cầu không hợp lệ (thiếu tham số, JSON không hợp lệ, v.v.)
• 404: Không tìm thấy (mô hình không tồn tại, v.v.)
• 429: Quá nhiều yêu cầu (ví dụ khi giới hạn tốc độ bị vượt quá)
• 500: Lỗi máy chủ nội bộ
• 502: Cổng không hợp lệ (ví dụ khi không thể kết nối đến mô hình đám mây)

Thông báo lỗi

Lỗi được trả về ở định dạng application/json với cấu trúc sau, với thông báo lỗi nằm trong thuộc tính error:

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

Lỗi xảy ra trong khi streaming

Nếu lỗi xảy ra giữa chừng trong quá trình streaming, lỗi sẽ được trả về dưới dạng đối tượng ở định dạng application/x-ndjson với thuộc tính error. Vì phản hồi đã bắt đầu, mã trạng thái của phản hồi sẽ không thay đổi.

{"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"}