Skip to main content
POST
Music Generation by Lyrics

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.