狀態碼

端點會根據請求的成功或失敗，在 HTTP 狀態列中返回適當的 HTTP 狀態碼（例如 HTTP/1.1 200 OK 或 HTTP/1.1 400 Bad Request）。常見的狀態碼包括：

• 200: 成功
• 400: 錯誤請求（缺少參數、無效的 JSON 等）
• 404: 未找到（模型不存在等）
• 429: 請求過多（例如當超過速率限制時）
• 500: 內部伺服器錯誤
• 502: 錯誤閘道（例如無法連接到雲端模型時）

錯誤訊息

錯誤將以 application/json 格式返回，結構如下，錯誤訊息位於 error 屬性中：

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

串流時發生的錯誤

如果發生在串流過程中的錯誤，該錯誤將以包含 error 屬性的物件形式，以 application/x-ndjson 格式返回。由於回應已經開始，回應的狀態碼將不會改變。

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