Skip to main content
POST
/
v1
/
music
/
musicgen
Music Generation by Lyrics
curl --request POST \
  --url https://apis.finevoice.ai/v1/music/musicgen \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "My AI Song",
  "style": "pop, energetic, upbeat",
  "audioId": "<string>",
  "referVoice": "<string>",
  "referInstrumental": "<string>",
  "lyrics": "[Verse 1]\nHello world, this is FineVoice...",
  "instrumental": false,
  "modelVersion": "v3"
}
'
{}

Authorizations

​
Authorization
string
header
required

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

Body

application/json

The music generation request payload.

​
title
string

The generated song title.

Example:

"My AI Song"

​
style
string

The target music style.

Example:

"pop, energetic, upbeat"

​
audioId
string

The source audio identifier.

​
referVoice
string

Reference vocal track identifier or URL.

​
referInstrumental
string

Reference instrumental track identifier or URL.

​
lyrics
string

The lyrics content.

Example:

"[Verse 1]\nHello world, this is FineVoice..."

​
instrumental
boolean

Whether to generate instrumental-only music.

Example:

false

​
modelVersion
enum<string>

Model version. v3: optimized for Chinese vocals and traditional styles. r2: studio recording quality with highly realistic vocals.

Available options:
v3,
r2
Example:

"v3"

Response

Task accepted.

The response is of type object.