錯誤處理與回應模型

OneASR 遵循標準 HTTP 狀態碼體系，並返回符合 OpenAI 規範的 JSON 錯誤內容。

---

錯誤回應 JSON 格式

{
  "error": {
    "message": "Invalid API key provided.",
    "type": "invalid_request_error",
    "param": null,
    "code": "invalid_api_key"
  }
}

---

常見 HTTP 狀態碼對照表

狀態碼	錯誤代碼 / 類型	說明
200 OK	-	請求成功。
400 Bad Request	invalid_request_error	缺少必要參數或上傳了不支援的音訊格式。
401 Unauthorized	invalid_api_key	請求未攜帶或攜帶了錯誤的 API Key。
404 Not Found	not_found_error	目標任務 ID 或模型不存在。
422 Unprocessable	validation_error	表單欄位驗證失敗。
500 Internal Server	server_error	後台推論 Worker 異常或顯示卡記憶體不足 (OOM)。