Skill: germey/acedatacloud-suno-music (version 1.0.0)

--- name: suno-music description: Generate AI music with Suno via AceDataCloud API. Use when creating songs from text prompts, generating lyrics, extending tracks, creating covers, extracting vocals, managing voice personas, or any music generation task. Supports text-to-music, custom styles, multi-format output (MP3, WAV, MIDI, MP4), and vocal separation. license: Apache-2.0 metadata: author: acedatacloud version: "1.0" compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-suno for tool-use. --- # Suno Music Generation Generate AI-powered music through AceDataCloud's Suno API. ## Authentication ```bash export ACEDATACLOUD_API_TOKEN="your-token-here" # Get your token at https://platform.acedata.cloud ``` ## Quick Start — Generate a Song ```bash 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 | Model | Best For | |-------|---------| | `chirp-v5` | Latest, highest quality | | `chirp-v4-5-plus` | Enhanced v4.5 | | `chirp-v4-5` | Good balance of quality and speed | | `chirp-v4` | Fast, reliable | | `chirp-v3-5` | Legacy, stable | ## Core Workflows ### 1. Quick Generation (Inspiration Mode) Generate a song from a text description. Suno creates lyrics, style, and music automatically. ```json 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. ```json 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. ```json 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. ```json 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 | Endpoint | Method | Purpose | |----------|--------|---------| | `/suno/lyrics` | POST | Generate structured lyrics from a prompt | | `/suno/style` | POST | Optimize/refine a style description | | `/suno/mashup-lyrics` | POST | Combine two sets of lyrics | | `/suno/mp4` | POST | Get MP4 video version of a song | | `/suno/wav` | POST | Convert to lossless WAV format | | `/suno/midi` | POST | Extract MIDI data for DAW editing | | `/suno/vox` | POST | Extract vocal track (stem separation) | | `/suno/timing` | POST | Get word-level timing/subtitles | | `/suno/persona` | POST | Save a vocal style as a reusable persona | | `/suno/upload` | POST | Upload external audio for extend/cover | | `/suno/tasks` | POST | Query task status and results | ## Task Polling All generation is async. Either use `"wait": true` for synchronous mode, or poll: ```json 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: ```bash 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


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)