Producer Music Generation
Generate AI music through AceDataCloud's Producer API.
Authentication
export ACEDATACLOUD_API_TOKEN="your-token-here"
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"}'
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 |
upload_cover | Create a cover from an uploaded reference audio |
upload_extend | Extend from an uploaded reference audio |
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 |
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",
"instrumental": false
}
3. Instrumental Only
POST /producer/audios
{
"action": "generate",
"prompt": "epic orchestral soundtrack for a movie trailer",
"instrumental": true
}
4. Extend Song
POST /producer/audios
{
"action": "extend",
"audio_id": "existing-audio-id",
"continue_at": 30
}
5. Replace Section
POST /producer/audios
{
"action": "replace_section",
"audio_id": "existing-audio-id",
"replace_section_start": 15,
"replace_section_end": 30
}
6. Cover from Upload
POST /producer/audios
{
"action": "upload_cover",
"audio_id": "uploaded-reference-id",
"cover_strength": 0.8
}
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 | 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) |
cover_strength | 0.2–1 | Cover similarity (default: 1.0) |
weirdness | 0–1 | Creative randomness (default: 0.5) |
seed | string | Seed for reproducibility |
Task Polling
POST /producer/tasks
{"task_id": "your-task-id"}
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 pointreplace_section_start / replace_section_end define the time range to regenerateweirdness at 0 = predictable, at 1 = highly experimental- Upload a reference audio first (
/producer/upload), then use the returned ID for upload_cover or upload_extend
- WAV and video downloads are separate endpoints — call them after the main generation completes