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

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]\
Neon lights reflect on wet streets\
[Chorus]\
Midnight 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

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 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 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