エラーハンドリングとレスポンスモデル

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	バックグラウンド推論ワーカーの例外エラー、または GPU メモリ不足（OOM）が発生しました。