{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/finevoice/main/json-schema/finevoice-speech-enhancement-request-schema.json",
  "title": "SpeechEnhancementRequest",
  "description": "The speech enhancement request payload.",
  "x-generated": "2026-10-22",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/finevoice-openapi-openapi.json#/components/schemas/SpeechEnhancementRequest",
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Audio file URL (http/https). Supports WAV/MP3/FLAC/AAC/OGG/OPUS/M4A/WEBM."
    },
    "model": {
      "type": "string",
      "description": "Enhancement model. Supported: `MossFormer2_SE_48K`, `FRCRN_SE_16K`, `MossFormerGAN_SE_16K`.",
      "default": "MossFormer2_SE_48K"
    },
    "use_vad": {
      "type": "boolean",
      "description": "Enable VAD (Voice Activity Detection) preprocessing.",
      "default": false
    },
    "enable_normalization": {
      "type": "boolean",
      "description": "Enable audio normalization after enhancement.",
      "default": false
    },
    "normalization_method": {
      "type": "string",
      "description": "Normalization method: `peak`, `rms`, or `both`.",
      "default": "peak"
    },
    "normalization_peak_db": {
      "type": "number",
      "description": "Target peak level in dBFS.",
      "default": -1.0
    },
    "normalization_rms_db": {
      "type": "number",
      "description": "Target RMS level in dBFS.",
      "default": -20.0
    },
    "output_format": {
      "type": "string",
      "description": "Output format: `wav`, `mp3`, `flac`, or `m4a`.",
      "default": "wav"
    }
  }
}