Skip to main content
POST
/
v1
/
music
/
cover
Music Cover
curl --request POST \
  --url https://apis.finevoice.ai/v1/music/cover \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "voice": "james",
  "pitch": 0,
  "outputFormat": "mp3",
  "audioName": "<string>",
  "audioCover": "<string>",
  "way": "m2",
  "cut": 123,
  "engine": "v5",
  "sourceUrl": "https://example.com/song.mp3",
  "singers": [
    {
      "voice": "james",
      "pitch": 123,
      "engine": "v5",
      "diffusion_steps": 123,
      "auto_f0_adjust": true
    }
  ],
  "instrument_pitch": 123,
  "pitch_control": "rmvpe",
  "diffusion_steps": 123,
  "auto_f0_adjust": true,
  "vocal_types": "solo"
}
'
{}

Authorizations

​
Authorization
string
header
required

Bearer token (API key). Format: Bearer {your_api_key}

Body

application/json

The music cover request payload.

​
voice
string

The primary target voice model name.

Example:

"james"

​
pitch
number<float>
default:0

Vocal pitch offset in semitones.

Required range: -12 <= x <= 12
Example:

0

​
outputFormat
string

The desired output format.

Example:

"mp3"

​
audioName
string

The output audio name.

​
audioCover
string

The cover image URL.

​
way
string

Processing mode. Must be m2.

Example:

"m2"

​
cut
integer<int32>

The cut mode.

​
engine
enum<string>

Voice conversion engine. v5: great for singing (rich vibrato, more noise). v7: great for speech (clean, stable).

Available options:
v5,
v7
Example:

"v5"

​
sourceUrl
string

The source audio URL.

Example:

"https://example.com/song.mp3"

​
singers
object[]

Singer configurations for a multi-singer cover.

​
instrument_pitch
number<float>

Instrumental pitch offset in semitones.

​
pitch_control
string

Pitch control mode. Must be rmvpe.

Example:

"rmvpe"

​
diffusion_steps
integer<int32>

Number of diffusion steps.

​
auto_f0_adjust
boolean

Whether to enable automatic F0 adjustment.

​
vocal_types
enum<string>
default:solo

Vocal type configuration.

Available options:
solo,
chorus,
duets
Example:

"solo"

Response

Task accepted.

The response is of type object.