producer-music

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Producer Music Generation

Producer 音乐生成

Generate AI music through AceDataCloud's Producer API.

Setup: See authentication for token setup.

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

设置： 请查看身份验证文档了解令牌设置方法。

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. Poll via
POST /producer/tasks
with
{"id": "..."}
every 3-5 seconds.

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"}'

异步处理： 所有生成操作均为异步。请查看异步任务轮询文档。每3-5秒通过
POST /producer/tasks
接口并携带
{"id": "..."}
进行轮询。

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

Model	说明
`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`	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

Action	描述
`generate`	根据提示词或自定义歌词创作新歌曲
`cover`	制作现有歌曲的翻唱版本
`extend`	从指定时间点继续扩展歌曲
`replace_section`	替换现有歌曲中的指定时间段内容
`swap_vocals`	提取并替换人声轨
`swap_instrumentals`	提取并替换乐器轨
`variation`	生成现有歌曲的变体版本
`stems`	将歌曲分离为stems（音轨分轨）

Workflows

工作流

1. Generate from Prompt

1. 根据提示词生成

json

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

json

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

2. Custom Lyrics Mode

2. 自定义歌词模式

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",
  "instrumental": false
}

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",
  "instrumental": false
}

3. Instrumental Only

3. 纯器乐模式

json

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

json

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

4. Extend Song

4. 扩展歌曲

json

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

json

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

5. Replace Section

5. 替换段落

json

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

json

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

6. Separate into Stems

6. 分离为stems

json

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

json

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

7. Generate Lyrics

7. 生成歌词

json

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

json

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

8. Get WAV / Video

8. 获取WAV文件/视频

json

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

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

json

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

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

9. Upload Reference Audio

9. 上传参考音频

json

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

json

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

Parameters

参数说明

Parameter	Type	Description
`action`	string	See actions table
`prompt`	string	Song description (for non-custom mode)
`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	Custom lyrics with `[Verse]` , `[Chorus]` tags
`audio_id`	string	Existing audio ID (for edit actions)
`continue_at`	number	Seconds — where to extend from
`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.7)
`sound_strength`	0.2-1	Sound quality weight (default: 0.7)
`weirdness`	0-1	Creative randomness (default: 0.5)
`seed`	string	Seed for reproducibility

Parameter	类型	描述
`action`	string	参见操作类型表格
`prompt`	string	歌曲描述（非自定义模式下使用）
`model`	string	模型（例如 `"FUZZ-2.0 Pro"` ）
`custom`	boolean	启用自定义歌词模式
`instrumental`	boolean	纯器乐（无人声）
`title`	string	歌曲标题
`lyric`	string	带有 `[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	用于结果复现的种子值

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

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

在自定义歌词中使用
```
[Verse]
```
、
```
[Chorus]
```
、
```
[Bridge]
```
、
```
[Outro]
```
标签
```
continue_at
```
参数单位为秒——歌曲从此时间点开始扩展

replace_section_start

replace_section_end

定义需要重新生成的时间段

```
weirdness
```
值为0时结果可预测，为1时具有高度实验性
通过
```
/producer/upload
```
接口上传参考音频以获取audio ID，用于
```
cover
```
或
```
extend
```
操作
WAV文件和视频下载为独立接口——需在主生成任务完成后调用
重要提示： 请检查任务响应中的
```
state
```
字段——只有当
```
state: "complete"
```
且
```
success: true
```
时才表示任务完成。在
```
pending
```
状态下，API可能返回临时的
```
audio_url
```
值（流式预览）。请勿因
```
audio_url
```
非空就停止轮询