{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/finevoice/main/json-schema/finevoice-post-v1-music-cover-request-schema.json",
  "title": "PostV1MusicCoverRequest",
  "x-generated": "2026-10-22",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_ae-authored/finevoice-openapi-generated.yml#/components/schemas/PostV1MusicCoverRequest",
  "type": "object",
  "properties": {
    "voice": {
      "type": "string",
      "description": "The primary target voice model name."
    },
    "pitch": {
      "type": "number",
      "description": "Vocal pitch offset in semitones."
    },
    "outputFormat": {
      "type": "string",
      "description": "The desired output format."
    },
    "audioName": {
      "type": "string",
      "description": "The output audio name."
    },
    "audioCover": {
      "type": "string",
      "description": "The cover image URL."
    },
    "way": {
      "type": "string",
      "description": "Processing mode. Must be `m2`."
    },
    "cut": {
      "type": "integer",
      "description": "The cut mode."
    },
    "engine": {
      "type": "string",
      "description": "Voice conversion engine. `v5`: great for singing (rich vibrato, more noise). `v7`: great for speech (clean, stable)."
    },
    "sourceUrl": {
      "type": "string",
      "description": "The source audio URL."
    },
    "singers": {
      "type": "array",
      "description": "Singer configurations for a multi-singer cover."
    },
    "instrument_pitch": {
      "type": "number",
      "description": "Instrumental pitch offset in semitones."
    },
    "pitch_control": {
      "type": "string",
      "description": "Pitch control mode. Must be `rmvpe`."
    },
    "diffusion_steps": {
      "type": "integer",
      "description": "Number of diffusion steps."
    },
    "auto_f0_adjust": {
      "type": "boolean",
      "description": "Whether to enable automatic F0 adjustment."
    },
    "vocal_types": {
      "type": "string",
      "description": "Vocal type configuration."
    }
  }
}