← 返回 Skills 市场

Topmediai AI Music Generator

Name: Topmediai AI Music Generator
Author: topmediai

作者 Topmediai · GitHub ↗ · v1.0.2 · MIT-0

cross-platform ✓ 安全检测通过

249

总下载

当前安装

版本数

在 OpenClaw 中安装

/install music-generator-topmediai

功能描述

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.

使用说明 (SKILL.md)

\r \r

Music Generator TopMediai Skill\r

Capability Overview\r

This skill supports:\r

Generate a full song with lyrics\r
Generate pure background music (BGM)\r
Generate lyrics only\r
Query music generation tasks\r
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

安全使用建议

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).

功能分析

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.

能力评估

✓ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install music-generator-topmediai
安装完成后，直接呼叫该 Skill 的名称或使用 /music-generator-topmediai 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

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.

元数据

Slug music-generator-topmediai

版本 1.0.2

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 3

常见问题