Background Music Generation

curl --request POST \ --url https://apis.finevoice.ai/v1/music/musicgenbyprompt \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "prompt": "Upbeat electronic dance music with heavy bass and synth leads", "instrumental": true, "duration": 30, "continuation": true, "title": "<string>", "modelVersion": "<string>", "audioId": "<string>", "prompt_type": "<string>", "input_audio": "<string>", "thumbnail_url": "<string>" } '

Authorizations

Authorization

string

header

required

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

Body

application/json

The prompt-based music generation request payload.

prompt

string

The generation prompt describing the desired music.

Example:

"Upbeat electronic dance music with heavy bass and synth leads"

instrumental

boolean

Whether to generate instrumental-only music (no vocals).

Example:

true

duration

integer<int32>

The target duration in seconds.

Example:

30

continuation

boolean

Whether this generation continues a previous clip.

title

string

The generated song title.

modelVersion

string

The model version to use.

audioId

string

Source audio identifier for continuation or reference.

prompt_type

string

The prompt input type.

input_audio

string

Optional input audio reference URL.

thumbnail_url

string

The thumbnail image URL.

Response

Task accepted.

The response is of type object.