К основному содержанию
скилл CX Codex

byted-music-generate — скилл для Claude Code

Скилл byted-music-generate для Claude Code генерирует через API Volcengine вокальные песни, инструментальный BGM и тексты песен. Создаёт музыку к проектам и саундтреки, пишет лирику.

Apache-2.0 103 установок ★ 494 обновлён 2026-10-22

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add bytedance/agentkit-samples --skill byted-music-generate -a claude-code
Открыть на GitHub

Что делает byted-music-generate

Скилл работает с тремя режимами. Режим song генерирует вокальную музыку по тексту песни или краткому описанию — нужно передать либо готовые куплеты и припев, либо тему, а скилл выберет жанр и голос. Режим bgm создаёт инструментальные треки по описанию: можно указать стиль (спокойная музыка в кофейне, эпический саундтрек для игры) и разбить трек на сегменты. Режим lyrics синхронно генерирует только текст песни без музыки, можно использовать как отдельно, так и как первый шаг перед генерацией вокала.

Для работы нужны учётные данные Volcengine: либо API gateway (переменные ARK_SKILL_API_BASE и ARK_SKILL_API_KEY), либо прямые AccessKey ID и Secret из консоли Volcengine. Генерация песни или BGM занимает несколько минут (обычно 1–5 минут) и идёт асинхронно — скилл опрашивает API и выводит результат JSON-строкой, когда готово. Если процесс перемещается в фон, нужно периодически (каждые 10 секунд) проверять вывод терминала.

Для song доступны параметры жанра, настроения, пола голоса, тембра, длительности, клавиши, темпа, инструментов и языка. Модель по умолчанию v4.3, для bgm используется v5.0. Длительность BGM — от 30 до 120 секунд, вокала — от 30 до 240.

Какие задачи решает

  • генерировать вокальную песню по описанию темы или готовому тексту
  • создать инструментальный трек для фоновой музыки или саундтрека
  • написать текст песни на основе идеи
  • составить структурированный BGM с куплетами, припевом и интро

Примеры запросов агенту

  • Напиши песню про летний пляж, женский голос, жанр поп
  • Создай релаксирующий инструментальный трек из пианино и гитары длиной 60 секунд
  • Сгенерируй текст песни про прощание после окончания, жанр фолк, печальное настроение

Как установить byted-music-generate

1Через Skills CLI (Vercel)

npx skills add bytedance/agentkit-samples --skill byted-music-generate -a claude-code

2Вручную: положить файлы

~/.claude/skills/byted-music-generate/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/byted-music-generate/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о byted-music-generate

Как установить byted-music-generate в Claude Code?

Выполни команду npx skills add bytedance/agentkit-samples --skill byted-music-generate -a claude-code, затем открой файл ~/.claude/skills/byted-music-generate/SKILL.md.

Что делает byted-music-generate?

Скилл генерирует музыку через API Volcengine: вокальные песни по тексту или описанию, инструментальные треки для фона, а также тексты песен. Генерация занимает несколько минут и идёт в фоне.

Какие учётные данные нужны для работы скилла?

Нужны ключи Volcengine: либо API gateway (ARK_SKILL_API_BASE и ARK_SKILL_API_KEY), либо AccessKey ID и Secret из консоли Volcengine. Приоритет у gateway.

Исходный текст

SKILL.md · Apache-2.0
---
name: byted-music-generate
description: Generate music using Volcengine Imagination API. Supports vocal songs, instrumental BGM, and lyrics generation. Use when the user wants to create songs, background music, soundtracks, write lyrics, or mentions "music generation", "BGM", or "songwriting".
license: Complete terms in LICENSE
---

# Music Generate Skill

Generate music using the [Volcengine Music Generation API](https://www.volcengine.com/docs/84992). Supports vocal songs, instrumental BGM, and AI lyrics generation.

## Trigger Conditions

1. User wants to generate a song (with lyrics or a text prompt)
2. User needs background music, instrumental tracks, or soundtracks
3. User wants AI-generated lyrics
4. User mentions "write a song", "music generation", "BGM", "background music", "lyrics"

## Environment Variables

Two authentication methods are supported (gateway takes priority):

**Option 1: API Gateway (recommended)**
- `ARK_SKILL_API_BASE` — API gateway base URL
- `ARK_SKILL_API_KEY` — API gateway authentication key

**Option 2: Direct AK/SK**
- `VOLCENGINE_ACCESS_KEY` — AccessKey ID
- `VOLCENGINE_SECRET_KEY` — AccessKey Secret
- How to obtain: [Volcengine Console](https://console.volcengine.com/) → Account → Key Management → Create Key

## Usage

1. Determine user intent and select the mode (`song` / `bgm` / `lyrics`).
2. `cd` to the skill directory: `skills/byted-music-generate`.
3. Run the script. The script polls the API internally and may take **several minutes** to complete (typically 1–5 minutes for song/bgm).
4. **Monitor execution**: If the runtime environment moves the command to background, you MUST periodically (every 10 seconds) read the terminal output to check whether the script has finished. The script prints polling progress to stderr and outputs a single JSON line to stdout upon completion.
5. Once completed, return the `audio_url` or `lyrics` from the JSON output to the user.

## Three Modes

### 1. song — Vocal Song

User provides lyrics (Lyrics) or a text prompt (Prompt) to generate a vocal song.

```bash
# With text prompt
python scripts/music_generate.py song --prompt "A song about summer at the beach" --genre Pop --gender Female

# With lyrics
python scripts/music_generate.py song --lyrics "[verse]\nMoonlight on the windowsill\nMemories flowing like water\n[chorus]\nYou are my moonlight" --genre Folk --mood "Sentimental/Melancholic/Lonely"
```

**Note**: `--lyrics` and `--prompt` are mutually exclusive; lyrics takes priority. If the user hasn't provided lyrics, you can first use the `lyrics` mode to generate them, then pass the result to the `song` mode.

### 2. bgm — Instrumental BGM

Describe the desired music in natural language. The v5.0 model does not require Genre/Mood parameters — just describe everything in the `--text` field.

```bash
python scripts/music_generate.py bgm --text "Relaxed coffee shop ambiance music with piano and guitar" --duration 60

# With song structure segments
python scripts/music_generate.py bgm --text "Epic game soundtrack" --segments '[{"Name":"intro","Duration":10},{"Name":"chorus","Duration":30}]'
```

### 3. lyrics — Lyrics Generation

Returns synchronously (no polling needed). Can be used standalone or as a pre-step for the `song` mode.

```bash
python scripts/music_generate.py lyrics --prompt "A song about graduation farewell" --genre Folk --mood "Sentimental/Melancholic/Lonely" --gender Female
```

### Manual Task Query (timeout fallback)

```bash
python scripts/music_generate.py query --task-id "202601397834584670076931"
```

## Mode Detection Logic

```
User Request
    ↓
Contains "instrumental/BGM/background music/soundtrack"?
    ├─ Yes → bgm mode
    └─ No → Contains "lyrics/write lyrics" and does NOT request audio?
        ├─ Yes → lyrics mode
        └─ No → song mode
            ├─ User provided lyrics → --lyrics
            └─ User only described a theme → --prompt (or lyrics first, then song)
```

## Script Parameters

### song mode

| Parameter         | Required | Description                                          |
|-------------------|----------|------------------------------------------------------|
| `--lyrics`        | either   | Lyrics with structure tags                           |
| `--prompt`        | either   | Text prompt (Chinese, 5-700 chars)                   |
| `--model-version` | no       | `v4.0` or `v4.3` (default: v4.3)                    |
| `--genre`         | no       | Music genre                                          |
| `--mood`          | no       | Music mood                                           |
| `--gender`        | no       | `Female` / `Male`                                    |
| `--timbre`        | no       | Vocal timbre                                         |
| `--duration`      | no       | Duration in seconds [30-240]                         |
| `--key`           | no       | Musical key (v4.3 only)                              |
| `--kmode`         | no       | `Major` / `Minor` (v4.3 only)                        |
| `--tempo`         | no       | Tempo (v4.3 only)                                    |
| `--instrument`    | no       | Instruments, comma-separated (v4.3 only)             |
| `--genre-extra`   | no       | Secondary genres, comma-separated, max 2 (v4.3 only) |
| `--scene`         | no       | Scene tags, comma-separated (v4.3 only)              |
| `--lang`          | no       | Language (v4.3 only)                                 |
| `--vod-format`    | no       | `wav` / `mp3` (v4.3 only)                            |
| `--billing`       | no       | `prepaid` / `postpaid` (default: postpaid)           |
| `--timeout`       | no       | Max wait seconds (default: 300)                      |

### bgm mode

| Parameter                | Required | Description                            |
|--------------------------|----------|----------------------------------------|
| `--text`                 | yes      | Natural language description           |
| `--duration`             | no       | Duration in seconds [30-120]           |
| `--segments`             | no       | JSON array of song structure segments  |
| `--version`              | no       | Model version (default: v5.0)          |
| `--enable-input-rewrite` | no       | Enable prompt rewriting                |
| `--billing`              | no       | `prepaid` / `postpaid` (default: postpaid) |
| `--timeout`              | no       | Max wait seconds (default: 300)        |

### lyrics mode

| Parameter | Required | Description                              |
|-----------|----------|------------------------------------------|
| `--prompt` | yes     | Lyrics prompt (Chinese only, <500 chars) |
| `--genre`  | no      | Music genre                              |
| `--mood`   | no      | Music mood                               |
| `--gender` | no      | `Female` / `Male`                        |

## Script Return Info

The script outputs JSON with the following fields:

```json
{
    "status": "success | timeout | error",
    "mode": "song | bgm | lyrics | query",
    "task_id": "...",
    "audio_url": "https://...",
    "duration": 46.0,
    "lyrics": "...",
    "error": null
}
```

Return the `audio_url` to the user for download or playback. URLs are valid for approximately 1 year, but users should save the file promptly.

## Error Handling

- IF the script raises `PermissionError: Authentication not configured ...`, inform the user to configure either API gateway (`ARK_SKILL_API_BASE` + `ARK_SKILL_API_KEY`) or direct AK/SK (`VOLCENGINE_ACCESS_KEY` + `VOLCENGINE_SECRET_KEY`) environment variables. Write them to the workspace environment variable file, then retry.
- IF `status` is `"timeout"`, the task is still generating. Provide the user with the `task_id` and the manual query command from the output.
- IF copyright check fails (code 50000001), suggest the user enrich the description or increase the audio duration, then retry.

## References

- Available parameter values (Genre/Mood/Timbre/Instrument etc.): [references/parameters.md](references/parameters.md)
- [Volcengine Music Generation Docs](https://www.volcengine.com/docs/84992)
- [API Signature Guide](https://www.volcengine.com/docs/6369/67269)

© bytedance · Apache-2.0 · bytedance/agentkit-samples

Похожие скиллы

Все скиллы по теме «ИИ и ML» →
pre-generation-check bitwize-music-studio Скилл pre-generation-check проверяет готовность трека или альбома к генерации в Suno и выдаёт итог READY или NOT READY. CX Codex +1 264установок producer-music acedatacloud Скилл producer-music генерирует музыку через AceDataCloud API: песни, тексты, каверы и инструментальные треки. Работает с продолжением, заменой фрагментов и разделением дорожек. CX Codex +1 236установок suno-music calesthio Скилл suno-music для Claude Code создаёт музыку в Suno и разбирает права на её использование. Он включается для генерации, редактирования треков и подготовки промптов. CX Codex +1 157установок elevenlabs-music-generation prime-skills Скилл elevenlabs-music-generation для Claude Code, Codex, Cursor, GitHub Copilot и Gemini CLI запускает ElevenLabs Music через runcomfy CLI и возвращает стереодорожку 44.1 кГц. CX Codex +1 387 700установок songwriterx egodevrjm Скилл songwriterx для Claude Code пишет полные песни разных жанров и готовит оптимизированные промпты для Suno AI. CX Codex +1 1установок ai-music-album nexu-io Скилл ai-music-album для Claude Code ведёт цикл создания музыкального альбома: от концепта и текстов до треклиста и экспорта. Включает работу над инди-релизами и брендовыми саундтреками. CX Codex +1 2 900установок

Из того же набора4

Спонсоры проекта

Компании, которые помогают держать аналитику открытой