{"skill":{"slug":"music-generator-topmediai","displayName":"Topmediai AI Music Generator","summary":"Generate AI music, BGM, or lyrics via TopMediai API. Supports auto polling and two-stage output (preview first, then final full audio) for generation tasks.","description":"---\r\nname: music-generator-topmediai\r\ndescription: |\r\n  Generate AI music, BGM, or lyrics via TopMediai API. Supports auto polling and two-stage output\r\n  (preview first, then final full audio) for generation tasks.\r\nauthor: TopMediai\r\n---\r\n\r\n# Music Generator TopMediai Skill\r\n\r\n## Capability Overview\r\nThis skill supports:\r\n1) Generate a full song with lyrics\r\n2) Generate pure background music (BGM)\r\n3) Generate lyrics only\r\n4) Query music generation tasks\r\n5) Convert song_id to MP4\r\n\r\n## Preflight Check (Mandatory)\r\n- Configure `TOPMEDIAI_API_KEY` in `<skill_root>/.env`\r\n- Optional: `TOPMEDIAI_BASE_URL` (default `https://api.topmediai.com`)\r\n- If key is missing, stop and ask user to configure.\r\n\r\n## Command\r\n- Main command: `/music_generator_topmediai`\r\n  - `mode=normal` (default): lyrics -> submit -> poll preview/full\r\n  - `mode=bgm`: instrumental generation -> poll preview/full\r\n  - `mode=lyrics`: lyrics only\r\n\r\n## API Endpoints Used\r\n- Generate lyrics: `POST {BASE_URL}/v1/lyrics`\r\n- Submit generation: `POST {BASE_URL}/v3/music/generate`\r\n- Query tasks: `GET {BASE_URL}/v3/music/tasks?ids=<id[,id2,...]>`\r\n- Generate MP4 by song_id: `POST {BASE_URL}/v3/music/generate-mp4?song_id=<song_id>`\r\n\r\n## Return Event Conventions\r\n- `lyrics_ready`\r\n- `submitted`\r\n- `preview_ready`\r\n- `full_ready`\r\n- `failed` / `timeout`\r\n","topics":["Music"],"tags":{"latest":"1.0.2"},"stats":{"comments":0,"downloads":680,"installsAllTime":25,"installsCurrent":0,"stars":2,"versions":3},"createdAt":1773661248622,"updatedAt":1778491948843},"latestVersion":{"version":"1.0.2","createdAt":1773665389720,"changelog":"Version 1.0.2 of music-generator-topmediai\n\n- No code or documentation changes detected in this release.\n- Version update only; functionality and usage remain unchanged.\n- update .env file","license":"MIT-0"},"metadata":{"setup":[],"os":null,"systems":null},"owner":{"handle":"topmediai","userId":"s17b24nnj4p0fgyssjfe8nwhxd83n6eq","displayName":"Topmediai","image":"https://avatars.githubusercontent.com/u/204978011?v=4"},"moderation":null}