エラーハンドリング & ステータスコード

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	サーバー内部エラーまたはエンジン合成処理の失敗