Topmediai AI Music Generator

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.

Audits

Pass

ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install music-generator-topmediai

Music Generator TopMediai Skill

Capability Overview

This skill supports:

Generate a full song with lyrics
Generate pure background music (BGM)
Generate lyrics only
Query music generation tasks
Convert song_id to MP4

Preflight Check (Mandatory)

Configure TOPMEDIAI_API_KEY in <skill_root>/.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=<id[,id2,...]>
Generate MP4 by song_id: POST {BASE_URL}/v3/music/generate-mp4?song_id=<song_id>

Return Event Conventions

lyrics_ready
submitted
preview_ready
full_ready
failed / timeout