Claude GitHub Copilot Skill

producer-music

Generate AI music with Producer via AceDataCloud API. Use when creating songs, generating lyrics, extending tracks, creating covers, swapping vocals/instrumentals, replacing song sections, or uploading reference audio. Supports custom lyrics, instrumental-only mode, and multiple

LLM Mart · 0 points · 2 views 0 listing impressions 0 install-command copies
Download AceDataCloud-Skills-skills_producer-music-57df236.zip · 3 KB

Install

skills CLI npx skills add https://github.com/AceDataCloud/Skills/tree/main/skills/producer-music
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install acedatacloud-skills@llmmart
Git git clone https://github.com/AceDataCloud/Skills.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole acedatacloud/skills collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

Producer Music Generation

Generate AI music through AceDataCloud's Producer API.

First-time setup

  1. Install the official Skill with clawhub install @acedatacloud/producer. Check that the ClawHub publisher is @acedatacloud.
  2. Sign in at AceDataCloud → Applications, open General application, and check Producer access, balance, and current pricing. Copy its API key, or select Manage Keys → Create for a separate key. Copy the key value without Bearer ; a platform-... management token is not a service API key.
  3. If you enable Allowed APIs restrictions, include /producer/audios and /producer/tasks. Advanced workflows below may call additional routes.
  4. On the OpenClaw Gateway host, put ACEDATACLOUD_API_TOKEN=your_api_key_here in ~/.openclaw/.env, then restart the Gateway and start a new session. For a direct terminal test, run export ACEDATACLOUD_API_TOKEN="your_api_key_here" in that shell. Never put the key in a prompt or commit an .env file.
  5. Run the Quick Start below. If it returns a task ID, query that same task until it finishes; do not submit a second billable generation just to check progress.

Illustrated key setup, first run, and troubleshooting · Token details

Quick Start

curl -X POST https://api.acedata.cloud/producer/audios \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "generate", "prompt": "upbeat electronic dance track with synth leads"}'

Async: All generation is async. See async task polling. Poll via POST /producer/tasks with {"id": "..."} every 3-5 seconds.

Models

Model Notes
FUZZ-2.0 Pro Default, highest quality
FUZZ-2.0 Standard quality
FUZZ-2.0 Raw Raw output variant
FUZZ-1.1 Pro Pro v1.1
FUZZ-1.0 Pro Pro v1.0
FUZZ-1.0 v1.0
FUZZ-1.1 v1.1
FUZZ-0.8 Legacy

Actions

Action Description
generate Create a new song from prompt or custom lyrics
cover Create a cover version of an existing song
extend Continue a song from a specific timestamp
replace_section Replace a time range in an existing song
swap_vocals Extract and swap vocal tracks
swap_instrumentals Extract and swap instrumental tracks
variation Generate a variation of an existing song
stems Separate a song into stems

Choose inputs by action

Always send action, then supply only the inputs needed for that operation:

Operation Required inputs
generate, custom=false (default) Nonempty prompt
generate, custom=true, instrumental=false Nonempty lyric
generate, custom=true, instrumental=true Neither lyrics nor an extra prompt is required
extend Source audio_id, continue_at > 0, and nonempty lyric unless instrumental=true
cover, variation, replace_section, swap_vocals, swap_instrumentals, stems Source audio_id; add the selected operation's editing controls

Do not insert empty lyrics or prompts just to satisfy a universal required-field rule. In MCP, supplying lyric to producer_extend_music or producer_replace_section selects custom lyrics mode; instrumental extension can omit lyrics with instrumental=true.

Workflows

1. Generate from Prompt

POST /producer/audios
{
  "action": "generate",
  "prompt": "chill lo-fi hip hop with rain sounds and soft piano"
}

2. Custom Lyrics Mode

POST /producer/audios
{
  "action": "generate",
  "custom": true,
  "title": "Midnight City",
  "lyric": "[Verse]\nNeon lights reflect on wet streets\n[Chorus]\nMidnight city never sleeps",
  "prompt": "nocturnal electronic pop",
  "instrumental": false
}

3. Instrumental Only

POST /producer/audios
{
  "action": "generate",
  "custom": true,
  "instrumental": true
}

4. Extend Song

POST /producer/audios
{
  "action": "extend",
  "audio_id": "existing-audio-id",
  "custom": true,
  "lyric": "[Verse]\nA new chapter starts tonight",
  "continue_at": 30.792
}

5. Replace Section

POST /producer/audios
{
  "action": "replace_section",
  "audio_id": "existing-audio-id",
  "custom": true,
  "lyric": "[Chorus]\nNew words for this section",
  "replace_section_start": 15,
  "replace_section_end": 30
}

6. Separate into Stems

POST /producer/audios
{
  "action": "stems",
  "audio_id": "existing-audio-id"
}

7. Generate Lyrics

POST /producer/lyrics
{
  "prompt": "a love song about stargazing on a summer night"
}

8. Get WAV / Video

POST /producer/wav
{"audio_id": "your-audio-id"}

POST /producer/videos
{"audio_id": "your-audio-id"}

9. Upload Reference Audio

POST /producer/upload
{
  "audio_url": "https://example.com/reference.mp3"
}

Parameters

Parameter Type Description
action string Required for every /producer/audios request; see actions table
prompt string Required for non-custom generate; not unconditionally required for editing or custom instrumental generation
model string Model (e.g., "FUZZ-2.0 Pro")
custom boolean Enable custom lyrics mode
instrumental boolean Pure instrumental (no vocals)
title string Song title
lyric string Required for custom non-instrumental generate and non-instrumental extend; use [Verse], [Chorus] tags
audio_id string Existing audio ID (for edit actions)
continue_at number Required for extend; seconds greater than 0, including fractional seconds
replace_section_start number Start time of section to replace
replace_section_end number End time of section to replace
lyrics_strength 0-1 Lyrics adherence (default: 0.5)
sound_strength 0.2-1 Sound quality weight (default: 0.5)
weirdness 0-1 Creative randomness (default: 0.5)
seed string Seed for reproducibility

Response Structure

{
  "data": [
    {
      "id": "audio-id",
      "audio_url": "https://cdn.example.com/song.mp3",
      "video_url": "https://cdn.example.com/video.mp4",
      "image_url": "https://cdn.example.com/cover.jpg",
      "title": "Song Title",
      "lyric": "full lyrics...",
      "style": "electronic, dance",
      "model": "FUZZ-2.0 Pro"
    }
  ]
}

Gotchas

  • Use [Verse], [Chorus], [Bridge], [Outro] tags in custom lyrics
  • continue_at is in seconds — the song extends from that point
  • replace_section_start / replace_section_end define the time range to regenerate
  • weirdness at 0 = predictable, at 1 = highly experimental
  • Upload a reference audio via /producer/upload to get an audio ID for use with cover or extend
  • WAV and video downloads are separate endpoints — call them after the main generation completes
  • CRITICAL: Check the state field in task responses — only state: "complete" with success: true means done. During pending, the API may return intermediate audio_url values (streaming previews). Do NOT stop polling just because audio_url is non-empty
Files (skills)
  • SKILL.md 7.9 KB
    ---
    name: producer-music
    description: Generate AI music with Producer via AceDataCloud API. Use when creating songs, generating lyrics, extending tracks, creating covers, swapping vocals/instrumentals, replacing song sections, or uploading reference audio. Supports custom lyrics, instrumental-only mode, and multiple creative actions.
    license: Apache-2.0
    metadata:
      author: acedatacloud
      version: "1.0"
    compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (get an API key at https://platform.acedata.cloud/console/applications).
    ---
    
    # Producer Music Generation
    
    Generate AI music through AceDataCloud's Producer API.
    
    ## First-time setup
    
    1. Install the official Skill with `clawhub install @acedatacloud/producer`. Check that the ClawHub publisher is **@acedatacloud**.
    2. Sign in at [AceDataCloud → Applications](https://platform.acedata.cloud/console/applications), open **General application**, and check Producer access, balance, and current pricing. Copy its API key, or select **Manage Keys → Create** for a separate key. Copy the key value without `Bearer `; a `platform-...` management token is not a service API key.
    3. If you enable **Allowed APIs** restrictions, include `/producer/audios` and `/producer/tasks`. Advanced workflows below may call additional routes.
    4. On the OpenClaw Gateway host, put `ACEDATACLOUD_API_TOKEN=your_api_key_here` in `~/.openclaw/.env`, then restart the Gateway and start a new session. For a direct terminal test, run `export ACEDATACLOUD_API_TOKEN="your_api_key_here"` in that shell. Never put the key in a prompt or commit an `.env` file.
    5. Run the **Quick Start** below. If it returns a task ID, query that same task until it finishes; do not submit a second billable generation just to check progress.
    
    [Illustrated key setup, first run, and troubleshooting](https://github.com/AceDataCloud/Skills#first-run-with-clawhub-and-openclaw) · [Token details](https://github.com/AceDataCloud/Skills/blob/main/skills/_shared/authentication.md)
    
    ## Quick Start
    
    ```bash
    curl -X POST https://api.acedata.cloud/producer/audios \
      -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{"action": "generate", "prompt": "upbeat electronic dance track with synth leads"}'
    ```
    
    > **Async:** All generation is async. See [async task polling](https://github.com/AceDataCloud/Skills/blob/main/skills/_shared/async-tasks.md). Poll via `POST /producer/tasks` with `{"id": "..."}` every 3-5 seconds.
    
    ## Models
    
    | Model | Notes |
    |-------|-------|
    | `FUZZ-2.0 Pro` | Default, highest quality |
    | `FUZZ-2.0` | Standard quality |
    | `FUZZ-2.0 Raw` | Raw output variant |
    | `FUZZ-1.1 Pro` | Pro v1.1 |
    | `FUZZ-1.0 Pro` | Pro v1.0 |
    | `FUZZ-1.0` | v1.0 |
    | `FUZZ-1.1` | v1.1 |
    | `FUZZ-0.8` | Legacy |
    
    ## Actions
    
    | Action | Description |
    |--------|-------------|
    | `generate` | Create a new song from prompt or custom lyrics |
    | `cover` | Create a cover version of an existing song |
    | `extend` | Continue a song from a specific timestamp |
    | `replace_section` | Replace a time range in an existing song |
    | `swap_vocals` | Extract and swap vocal tracks |
    | `swap_instrumentals` | Extract and swap instrumental tracks |
    | `variation` | Generate a variation of an existing song |
    | `stems` | Separate a song into stems |
    
    ## Choose inputs by action
    
    Always send `action`, then supply only the inputs needed for that operation:
    
    | Operation | Required inputs |
    |---|---|
    | `generate`, `custom=false` (default) | Nonempty `prompt` |
    | `generate`, `custom=true`, `instrumental=false` | Nonempty `lyric` |
    | `generate`, `custom=true`, `instrumental=true` | Neither lyrics nor an extra prompt is required |
    | `extend` | Source `audio_id`, `continue_at > 0`, and nonempty `lyric` unless `instrumental=true` |
    | `cover`, `variation`, `replace_section`, `swap_vocals`, `swap_instrumentals`, `stems` | Source `audio_id`; add the selected operation's editing controls |
    
    Do not insert empty lyrics or prompts just to satisfy a universal required-field rule. In MCP, supplying `lyric` to `producer_extend_music` or `producer_replace_section` selects custom lyrics mode; instrumental extension can omit lyrics with `instrumental=true`.
    
    ## Workflows
    
    ### 1. Generate from Prompt
    
    ```json
    POST /producer/audios
    {
      "action": "generate",
      "prompt": "chill lo-fi hip hop with rain sounds and soft piano"
    }
    ```
    
    ### 2. Custom Lyrics Mode
    
    ```json
    POST /producer/audios
    {
      "action": "generate",
      "custom": true,
      "title": "Midnight City",
      "lyric": "[Verse]\nNeon lights reflect on wet streets\n[Chorus]\nMidnight city never sleeps",
      "prompt": "nocturnal electronic pop",
      "instrumental": false
    }
    ```
    
    ### 3. Instrumental Only
    
    ```json
    POST /producer/audios
    {
      "action": "generate",
      "custom": true,
      "instrumental": true
    }
    ```
    
    ### 4. Extend Song
    
    ```json
    POST /producer/audios
    {
      "action": "extend",
      "audio_id": "existing-audio-id",
      "custom": true,
      "lyric": "[Verse]\nA new chapter starts tonight",
      "continue_at": 30.792
    }
    ```
    
    ### 5. Replace Section
    
    ```json
    POST /producer/audios
    {
      "action": "replace_section",
      "audio_id": "existing-audio-id",
      "custom": true,
      "lyric": "[Chorus]\nNew words for this section",
      "replace_section_start": 15,
      "replace_section_end": 30
    }
    ```
    
    ### 6. Separate into Stems
    
    ```json
    POST /producer/audios
    {
      "action": "stems",
      "audio_id": "existing-audio-id"
    }
    ```
    
    ### 7. Generate Lyrics
    
    ```json
    POST /producer/lyrics
    {
      "prompt": "a love song about stargazing on a summer night"
    }
    ```
    
    ### 8. Get WAV / Video
    
    ```json
    POST /producer/wav
    {"audio_id": "your-audio-id"}
    
    POST /producer/videos
    {"audio_id": "your-audio-id"}
    ```
    
    ### 9. Upload Reference Audio
    
    ```json
    POST /producer/upload
    {
      "audio_url": "https://example.com/reference.mp3"
    }
    ```
    
    ## Parameters
    
    | Parameter | Type | Description |
    |-----------|------|-------------|
    | `action` | string | Required for every `/producer/audios` request; see actions table |
    | `prompt` | string | Required for non-custom `generate`; not unconditionally required for editing or custom instrumental generation |
    | `model` | string | Model (e.g., `"FUZZ-2.0 Pro"`) |
    | `custom` | boolean | Enable custom lyrics mode |
    | `instrumental` | boolean | Pure instrumental (no vocals) |
    | `title` | string | Song title |
    | `lyric` | string | Required for custom non-instrumental `generate` and non-instrumental `extend`; use `[Verse]`, `[Chorus]` tags |
    | `audio_id` | string | Existing audio ID (for edit actions) |
    | `continue_at` | number | Required for `extend`; seconds greater than 0, including fractional seconds |
    | `replace_section_start` | number | Start time of section to replace |
    | `replace_section_end` | number | End time of section to replace |
    | `lyrics_strength` | 0-1 | Lyrics adherence (default: 0.5) |
    | `sound_strength` | 0.2-1 | Sound quality weight (default: 0.5) |
    | `weirdness` | 0-1 | Creative randomness (default: 0.5) |
    | `seed` | string | Seed for reproducibility |
    
    ## Response Structure
    
    ```json
    {
      "data": [
        {
          "id": "audio-id",
          "audio_url": "https://cdn.example.com/song.mp3",
          "video_url": "https://cdn.example.com/video.mp4",
          "image_url": "https://cdn.example.com/cover.jpg",
          "title": "Song Title",
          "lyric": "full lyrics...",
          "style": "electronic, dance",
          "model": "FUZZ-2.0 Pro"
        }
      ]
    }
    ```
    
    ## Gotchas
    
    - Use `[Verse]`, `[Chorus]`, `[Bridge]`, `[Outro]` tags in custom lyrics
    - `continue_at` is in **seconds** — the song extends from that point
    - `replace_section_start` / `replace_section_end` define the time range to regenerate
    - `weirdness` at 0 = predictable, at 1 = highly experimental
    - Upload a reference audio via `/producer/upload` to get an audio ID for use with `cover` or `extend`
    - WAV and video downloads are separate endpoints — call them after the main generation completes
    - **CRITICAL:** Check the `state` field in task responses — only `state: "complete"` with `success: true` means done. During `pending`, the API may return intermediate `audio_url` values (streaming previews). Do NOT stop polling just because `audio_url` is non-empty
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.