producer-music

Producer 音乐生成

通过 AceDataCloud 的 Producer API 生成 AI 音乐。

首次设置

1. 使用 clawhub install @acedatacloud/producer 安装官方 Skill。请确认 ClawHub 发布者是 @acedatacloud。
2. 登录 AceDataCloud → Applications，打开 General application，并检查 Producer 访问权限、余额和当前定价。复制其 API 密钥，或选择 Manage Keys → Create 创建单独的密钥。复制密钥值时不要包含 Bearer ；platform-... 管理令牌不是服务 API 密钥。
3. 如果启用了 Allowed APIs 限制，请加入 /producer/audios 和 /producer/tasks。以下高级工作流可能会调用其他路由。
4. 在 OpenClaw Gateway 主机上，将 ACEDATACLOUD_API_TOKEN=your_api_key_here 写入 ~/.openclaw/.env，然后重启 Gateway 并开始新会话。若要直接在终端中测试，请在该 shell 中运行 export ACEDATACLOUD_API_TOKEN="your_api_key_here"。切勿将密钥放入提示词或提交 .env 文件。
5. 运行下方的 Quick Start。如果返回任务 ID，请查询同一任务，直到任务完成；不要仅为检查进度而再次提交需要付费的生成任务。

密钥设置、首次运行和故障排除说明图解 · 令牌详情

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", "lyric": "", "prompt": "upbeat electronic dance track with synth leads"}'

异步： 所有生成操作均为异步。请参阅异步任务轮询。每隔 3-5 秒通过 POST /producer/tasks 和 {"id": "..."} 进行轮询。

Models

Model	Notes
FUZZ-2.0 Pro	默认，最高品质
FUZZ-2.0	标准品质
FUZZ-2.0 Raw	原始输出变体
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	旧版

Actions

Action	Description
generate	根据提示词或自定义歌词创作新歌曲
cover	为现有歌曲创作翻唱版本
extend	从指定时间戳继续创作歌曲
replace_section	替换现有歌曲中的一段时间范围
swap_vocals	提取并替换人声轨道
swap_instrumentals	提取并替换伴奏轨道
variation	生成现有歌曲的变体
stems	将歌曲分离为各个音轨

Workflows

1. 根据提示词生成

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

2. 自定义歌词模式

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. 纯伴奏

POST /producer/audios
{
  "action": "generate",
  "lyric": "",
  "prompt": "epic orchestral soundtrack for a movie trailer",
  "instrumental": true
}

4. 延续歌曲

POST /producer/audios
{
  "action": "extend",
  "audio_id": "existing-audio-id",
  "lyric": "",
  "prompt": "",
  "continue_at": 30
}

5. 替换片段

POST /producer/audios
{
  "action": "replace_section",
  "audio_id": "existing-audio-id",
  "lyric": "",
  "prompt": "",
  "replace_section_start": 15,
  "replace_section_end": 30
}

6. 分离音轨

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

7. 生成歌词

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

8. 获取 WAV / 视频

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

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

9. 上传参考音频

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

参数

参数	类型	说明
action	string	每个 /producer/audios 请求都必须提供；请参阅操作表
prompt	string	每个 /producer/audios 请求都必须提供；编辑操作不使用提示词时，请使用空字符串
model	string	模型（例如 "FUZZ-2.0 Pro"）
custom	boolean	启用自定义歌词模式
instrumental	boolean	纯器乐（无演唱）
title	string	歌曲标题
lyric	string	每个 /producer/audios 请求都必须提供；自定义歌词使用 [Verse]、[Chorus] 标签，否则使用空字符串
audio_id	string	已有音频 ID（用于编辑操作）
continue_at	number	秒数——从何处开始延长
replace_section_start	number	要替换片段的开始时间
replace_section_end	number	要替换片段的结束时间
lyrics_strength	0-1	歌词贴合度（默认值：0.7）
sound_strength	0.2-1	音质权重（默认值：0.7）
weirdness	0-1	创意随机度（默认值：0.5）
seed	string	用于确保结果可复现的种子

响应结构

{
  "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"
    }
  ]
}

注意事项

• 自定义歌词中使用 [Verse]、[Chorus]、[Bridge]、[Outro] 标签
• continue_at 的单位是秒——歌曲会从该时间点开始延长
• replace_section_start / replace_section_end 用于定义重新生成的时间范围
• weirdness 为 0 时结果可预测，为 1 时则高度实验性
• 通过 /producer/upload 上传参考音频，以获取可用于 cover 或 extend 的音频 ID
• WAV 和视频下载使用单独的端点——主生成完成后再调用这些端点
• 重要： 检查任务响应中的 state 字段——只有 state: "complete" 且 success: true 才表示完成。在 pending 状态期间，API 可能会返回中间的 audio_url 值（流式预览）。不要仅因为 audio_url 非空就停止轮询