Music Generator TopMediai Skill

Capability Overview

This skill supports:

1) Generate a full song with lyrics

2) Generate pure background music (BGM)

3) Generate lyrics only

4) Query music generation tasks

5) Convert song_id to MP4

Preflight Check (Mandatory)

• Configure TOPMEDIAI_API_KEY in /.env
• Optional: TOPMEDIAI_BASE_URL (default https://api.topmediai.com)
• If key is missing, stop and ask user to configure.

Command

• Main command: /music_generator_topmediai
• mode=normal (default): lyrics -> submit -> poll preview/full
• mode=bgm: instrumental generation -> poll preview/full
• mode=lyrics: lyrics only

API Endpoints Used

• Generate lyrics: POST {BASE_URL}/v1/lyrics
• Submit generation: POST {BASE_URL}/v3/music/generate
• Query tasks: GET {BASE_URL}/v3/music/tasks?ids=
• Generate MP4 by song_id: POST {BASE_URL}/v3/music/generate-mp4?song_id=

Return Event Conventions

• lyrics_ready
• submitted
• preview_ready
• full_ready
• failed / timeout