Suno Music Generation

Generate AI-powered music through AceDataCloud's Suno API.

Authentication

export ACEDATACLOUD_API_TOKEN="your-token-here"
# Get your token at https://platform.acedata.cloud

Quick Start — Generate a Song

curl -X POST https://api.acedata.cloud/suno/audios \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a happy pop song about coding", "model": "chirp-v4-5", "wait": true}'

Available Models

Core Workflows

1. Quick Generation (Inspiration Mode)

Generate a song from a text description. Suno creates lyrics, style, and music automatically.

POST /suno/audios
{
  "prompt": "an upbeat electronic track about the future of AI",
  "model": "chirp-v4-5",
  "instrumental": false
}

2. Custom Generation (Full Control)

Provide your own lyrics, title, and style for precise control.

POST /suno/audios
{
  "action": "custom",
  "lyric": "[Verse]\nCode is poetry in motion\n[Chorus]\nWe build the future tonight",
  "title": "Digital Dreams",
  "style": "Synthwave, Electronic, Dreamy",
  "model": "chirp-v4-5",
  "vocal_gender": "f"
}

3. Extend a Song

Continue an existing song from a specific timestamp with new lyrics.

POST /suno/audios
{
  "action": "extend",
  "audio_id": "existing-audio-id",
  "lyric": "[Bridge]\nNew section lyrics here",
  "continue_at": 120.0,
  "style": "Same style as original"
}

4. Cover / Remix

Create a new version of an existing song in a different style.

POST /suno/audios
{
  "action": "cover",
  "audio_id": "existing-audio-id",
  "style": "Jazz, Acoustic, Mellow"
}

5. Full Song Creation Workflow

For best results follow this multi-step workflow:

1. Generate lyrics — POST /suno/lyrics with a topic/prompt
2. Optimize style — POST /suno/style to refine style description
3. Generate music — POST /suno/audios with custom action, lyrics + style
4. Poll task — POST /suno/tasks with task_id until status is complete
5. Optional: Extend — Use extend action to add more sections
6. Optional: Concat — Use concat action to merge extended segments
7. Optional: Convert — Get WAV (/suno/wav), MIDI (/suno/midi), or MP4 (/suno/mp4)

Auxiliary Endpoints

Task Polling

All generation is async. Either use "wait": true for synchronous mode, or poll:

POST /suno/tasks
{"task_id": "your-task-id"}

Poll every 3–5 seconds until status is "complete".

Lyrics Format

Use section markers in square brackets:

[Verse 1]
Your verse lyrics here

[Chorus]
Catchy chorus lyrics

[Bridge]
Bridge section

[Outro]
Ending lyrics

MCP Server Integration

For tool-use with Claude/Copilot, install the MCP server:

pip install mcp-suno

Or use the hosted endpoint: https://suno.mcp.acedata.cloud/mcp

Key tools: suno_generate_music, suno_generate_custom_music, suno_extend_music, suno_cover_music, suno_generate_lyrics, suno_optimize_style

Gotchas

• All generation is async — always poll /suno/tasks or use "wait": true
• Lyrics max ~3000 characters. For longer songs, use the extend workflow
• Style tags are descriptive phrases, not enum values (e.g., "Synthwave, Electronic, Dreamy")
• vocal_gender ("f"/"m") is only supported on v4.5+ models
• The concat action merges extended song segments — requires audio_id of the extended track
• persona requires an existing audio_id to extract the vocal reference from
• Upload external audio via /suno/upload before using it with extend/cover