Configuration
How to select background music:
"random"— pick a random MP3 from theresource/songs/library""(empty string) — disable background music entirely
Filename of a specific MP3 to use, e.g.
"output013.mp3". The file must exist in the resource/songs/ directory. Takes precedence over bgm_type when set.Background music volume relative to the voice narration. Range:
0.0 (silent) to 1.0 (full volume). The default of 0.2 keeps music subtle so it does not overpower the voice.Built-in music library
The project ships with a set of default background tracks located inresource/songs/. You can list available tracks via the API:
Adding your own music
You can add custom background music in two ways:- Upload via API
- Copy files manually
Use the
POST /api/v1/musics endpoint to upload an MP3 file. It will be saved to the resource/songs/ directory and immediately available.Disabling background music
To generate videos without any background music, setbgm_type to an empty string in your API request: