← Back to Skills Marketplace
topmediai

Topmediai AI Music Generator

by Topmediai · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ✓ Security Clean
249
Downloads
2
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install music-generator-topmediai
Description
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.
README (SKILL.md)

\r \r

Music Generator TopMediai Skill\r

\r

Capability Overview\r

This skill supports:\r

  1. Generate a full song with lyrics\r
  2. Generate pure background music (BGM)\r
  3. Generate lyrics only\r
  4. Query music generation tasks\r
  5. Convert song_id to MP4\r \r

Preflight Check (Mandatory)\r

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

Command\r

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

API Endpoints Used\r

  • Generate lyrics: POST {BASE_URL}/v1/lyrics\r
  • Submit generation: POST {BASE_URL}/v3/music/generate\r
  • Query tasks: GET {BASE_URL}/v3/music/tasks?ids=\x3Cid[,id2,...]>\r
  • Generate MP4 by song_id: POST {BASE_URL}/v3/music/generate-mp4?song_id=\x3Csong_id>\r \r

Return Event Conventions\r

  • lyrics_ready\r
  • submitted\r
  • preview_ready\r
  • full_ready\r
  • failed / timeout\r
Usage Guidance
This skill appears coherent and implements a TopMediai API client. Before installing: (1) Only provide a TopMediai API key (TOPMEDIAI_API_KEY) if you trust the TopMediai service. (2) Install the Python dependencies (requests, python-dotenv) in an isolated environment. (3) The skill runs local Python subprocesses and will poll the API (defaults to up to 900s) — expect long-running subprocesses for generation tasks. (4) If you override TOPMEDIAI_BASE_URL, point it only to a trusted endpoint (otherwise network requests could go to an unexpected host). (5) Review the included scripts if you need assurance they only access the skill workspace and the declared .env file (they do).
Capability Analysis
Type: OpenClaw Skill Name: music-generator-topmediai Version: 1.0.2 The skill is a legitimate integration for the TopMediai AI music generation service, allowing users to generate lyrics, BGM, and full songs. The implementation in `topmediai_api.py` and `dispatch_music_generator.py` uses standard Python libraries (requests, argparse) to interact with the official API (api.topmediai.com) and includes proper security practices such as masking API keys in debug logs. No evidence of data exfiltration, malicious execution, or prompt injection was found.
Capability Assessment
✓ Purpose & Capability
Name/description, plugin.json, SKILL.md and the included Python code all consistently implement a TopMediai client (lyrics generation, music generation, task polling, MP4 generation). Required env var (TOPMEDIAI_API_KEY) and optional TOPMEDIAI_BASE_URL are appropriate and expected.
✓ Instruction Scope
Runtime instructions and the scripts only load .env, read the declared environment variables, call TopMediai endpoints, and emit JSON to stdout. The SKILL.md and code do not instruct reading unrelated system files or exfiltrating secrets to unknown endpoints.
ℹ Install Mechanism
No registry install spec is present (instruction-only at registry level) but the bundle includes code and a requirements.txt (requests, python-dotenv). This is reasonable for a Python CLI skill, but the user must run pip install -r requirements.txt manually or otherwise ensure those packages are available.
✓ Credentials
Only TOPMEDIAI_API_KEY is required (plugin.json declares it). TOPMEDIAI_BASE_URL and TOPMEDIAI_DEBUG are optional. No unrelated credentials or config paths are requested.
✓ Persistence & Privilege
The skill is user-invocable, not forced-always, and does not modify system-wide agent settings. It runs as subprocesses in the workspace and does not attempt to persist credentials beyond reading .env.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install music-generator-topmediai
  3. After installation, invoke the skill by name or use /music-generator-topmediai
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
Version 1.0.2 of music-generator-topmediai - No code or documentation changes detected in this release. - Version update only; functionality and usage remain unchanged. - update .env file
v1.0.1
- rename displayname - No code or documentation changes detected in this release. - Version number updated to 1.0.1. - Existing features and APIs remain unchanged.
v1.0.0
music-generator-topmediai v1.0.0 - Initial release. - Generate AI music, background music (BGM), or lyrics via TopMediai API. - Supports auto polling and two-stage output (preview, then full audio). - Includes optional MP4 conversion by song_id. - Requires pre-configuration of the TOPMEDIAI_API_KEY.
Metadata
Slug music-generator-topmediai
Version 1.0.2
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is 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. It is an AI Agent Skill for Claude Code / OpenClaw, with 249 downloads so far.

How do I install Topmediai AI Music Generator?

Run "/install music-generator-topmediai" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Topmediai AI Music Generator free?

Yes, Topmediai AI Music Generator is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Topmediai AI Music Generator support?

Topmediai AI Music Generator is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Topmediai AI Music Generator?

It is built and maintained by Topmediai (@topmediai); the current version is v1.0.2.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463942 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259883 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200739 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191401 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190375 · by oswalpalash

💬 Comments