Music Generate Skill

Trigger Conditions

1. User wants to generate a song (with lyrics or a text prompt)
2. User needs background music, instrumental tracks, or soundtracks
3. User wants AI-generated lyrics
4. User mentions "write a song", "music generation", "BGM", "background music", "lyrics"

Environment Variables

• VOLCENGINE_ACCESS_KEY

  — AccessKey ID

• VOLCENGINE_SECRET_KEY

  — AccessKey Secret

Usage

1. Determine user intent and select the mode (

   song

   /

   bgm

   /

   lyrics

   ).

2. cd

   to the skill directory:

   skills/byted-music-generate

   .
3. Run the script. The script polls the API internally and may take several minutes to complete (typically 1–5 minutes for song/bgm).
4. Monitor execution: If the runtime environment moves the command to background, you MUST periodically (every 10 seconds) read the terminal output to check whether the script has finished. The script prints polling progress to stderr and outputs a single JSON line to stdout upon completion.
5. Once completed, return the

   audio_url

   or

   lyrics

   from the JSON output to the user.

Three Modes

1. song — Vocal Song

# With text prompt
python scripts/music_generate.py song --prompt "A song about summer at the beach" --genre Pop --gender Female

# With lyrics
python scripts/music_generate.py song --lyrics "[verse]\nMoonlight on the windowsill\nMemories flowing like water\n[chorus]\nYou are my moonlight" --genre Folk --mood "Sentimental/Melancholic/Lonely"

--lyrics

--prompt

lyrics

song

2. bgm — Instrumental BGM

--text

python scripts/music_generate.py bgm --text "Relaxed coffee shop ambiance music with piano and guitar" --duration 60

# With song structure segments
python scripts/music_generate.py bgm --text "Epic game soundtrack" --segments '[{"Name":"intro","Duration":10},{"Name":"chorus","Duration":30}]'

3. lyrics — Lyrics Generation

song

python scripts/music_generate.py lyrics --prompt "A song about graduation farewell" --genre Folk --mood "Sentimental/Melancholic/Lonely" --gender Female

Manual Task Query (timeout fallback)

python scripts/music_generate.py query --task-id "202601397834584670076931"

Mode Detection Logic

User Request
    ↓
Contains "instrumental/BGM/background music/soundtrack"?
    ├─ Yes → bgm mode
    └─ No → Contains "lyrics/write lyrics" and does NOT request audio?
        ├─ Yes → lyrics mode
        └─ No → song mode
            ├─ User provided lyrics → --lyrics
            └─ User only described a theme → --prompt (or lyrics first, then song)

Script Parameters

song mode

--lyrics

--prompt

--model-version

v4.0

v4.3

--genre

--mood

--gender

Female

Male

--timbre

--duration

--key

--kmode

Major

Minor

--tempo

--instrument

--genre-extra

--scene

--lang

--vod-format

wav

mp3

--billing

prepaid

postpaid

--timeout

bgm mode

--text

--duration

--segments

--version

--enable-input-rewrite

--billing

prepaid

postpaid

--timeout

lyrics mode

--prompt

--genre

--mood

--gender

Female

Male

Script Return Info

{
    "status": "success | timeout | error",
    "mode": "song | bgm | lyrics | query",
    "task_id": "...",
    "audio_url": "https://...",
    "duration": 46.0,
    "lyrics": "...",
    "error": null
}

audio_url

Error Handling

• PermissionError: VOLCENGINE_ACCESS_KEY ...

  : Inform the user to configure the environment variables. Write them to the workspace environment variable file, then retry.

• status: "timeout"

  : The task is still generating. Provide the user with the

  task_id

  and the manual query command from the output.
• Copyright check failure (code 50000001): Suggest the user enrich the description or increase the audio duration, then retry.

References

• Available parameter values (Genre/Mood/Timbre/Instrument etc.): references/parameters.md
• Volcengine Music Generation Docs
• API Signature Guide