错误码与状态码规范

OneTTS 全局使用标准 OpenAI 错误结构包裹所有异常响应。

---

🛑 统一错误响应结构

{
  "error": {
    "message": "Incorrect API key provided or missing Authorization header.",
    "type": "invalid_request_error",
    "param": null,
    "code": "invalid_api_key"
  },
  "detail": "Incorrect API key provided or missing Authorization header."
}

---

📊 HTTP 状态码对照

状态码	错误类型 (type)	场景说明
400	invalid_request_error	缺少必填参数或字段校验失败
401	authentication_error	API Key 缺失或鉴权失败
404	not_found_error	访问的资源路径不存在
500	api_error	服务端内部异常或引擎合成故障