错误处理与响应模型

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)。