{"id":"d489787f-9c89-4115-8348-2a66ff540d84","shortId":"LFfnPe","kind":"skill","title":"suno-music","tagline":"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 ","description":"# Suno Music Generation\n\nGenerate AI-powered music through AceDataCloud's Suno API.\n\n> **Setup:** See [authentication](../_shared/authentication.md) for token setup.\n\n## Quick Start\n\n```bash\ncurl -X POST https://api.acedata.cloud/suno/audios \\\n  -H \"Authorization: Bearer $ACEDATACLOUD_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"prompt\": \"a happy pop song about coding\", \"model\": \"chirp-v5-5\", \"callback_url\": \"https://api.acedata.cloud/health\"}'\n```\n\n> **Async:** All generation is async. See [async task polling](../_shared/async-tasks.md). Poll via `POST /suno/tasks` with `{\"task_id\": \"...\"}` every 3-5 seconds.\n\n## Available Models\n\n| Model | Best For |\n|-------|---------|\n| `chirp-v5-5` | Latest, highest quality |\n| `chirp-v5` | High quality |\n| `chirp-v4-5-plus` | Enhanced v4.5 |\n| `chirp-v4-5` | Good balance of quality and speed |\n| `chirp-v4` | Fast, reliable |\n| `chirp-v3-5` | Legacy, stable |\n| `chirp-v3-0` | Legacy |\n\n## Core Workflows\n\n### 1. Quick Generation (Inspiration Mode)\n\nGenerate a song from a text description. Suno creates lyrics, style, and music automatically.\n\n```json\nPOST /suno/audios\n{\n  \"prompt\": \"an upbeat electronic track about the future of AI\",\n  \"model\": \"chirp-v5-5\",\n  \"instrumental\": false\n}\n```\n\n### 2. Custom Generation (Full Control)\n\nProvide your own lyrics, title, and style for precise control.\n\n```json\nPOST /suno/audios\n{\n  \"custom\": true,\n  \"lyric\": \"[Verse]\\nCode is poetry in motion\\n[Chorus]\\nWe build the future tonight\",\n  \"title\": \"Digital Dreams\",\n  \"style\": \"Synthwave, Electronic, Dreamy\",\n  \"model\": \"chirp-v5-5\",\n  \"vocal_gender\": \"f\"\n}\n```\n\n### 3. Extend a Song\n\nContinue an existing song from a specific timestamp with new lyrics.\n\n```json\nPOST /suno/audios\n{\n  \"action\": \"extend\",\n  \"audio_id\": \"existing-audio-id\",\n  \"lyric\": \"[Bridge]\\nNew section lyrics here\",\n  \"continue_at\": 120.0,\n  \"style\": \"Same style as original\"\n}\n```\n\n### 4. Cover / Remix\n\nCreate a new version of an existing song in a different style.\n\n```json\nPOST /suno/audios\n{\n  \"action\": \"cover\",\n  \"audio_id\": \"existing-audio-id\",\n  \"style\": \"Jazz, Acoustic, Mellow\"\n}\n```\n\n### 5. Full Song Creation Workflow\n\nFor best results follow this multi-step workflow:\n\n1. **Generate lyrics** — `POST /suno/lyrics` with a topic/prompt\n2. **Optimize style** — `POST /suno/style` to refine style description\n3. **Generate music** — `POST /suno/audios` with custom action, lyrics + style\n4. **Poll task** — `POST /suno/tasks` with task_id until status is complete\n5. **Optional: Extend** — Use extend action to add more sections\n6. **Optional: Concat** — Use concat action to merge extended segments\n7. **Optional: Convert** — Get WAV (`/suno/wav`), MIDI (`/suno/midi`), or MP4 (`/suno/mp4`)\n\n## Available Actions\n\n| Action | Description |\n|--------|-------------|\n| `generate` | Generate from prompt (default) |\n| `extend` | Continue an existing audio from a timestamp |\n| `upload_extend` | Upload external audio, then extend it |\n| `upload_cover` | Upload external audio, then create a cover |\n| `concat` | Concatenate extended segments into one track |\n| `cover` | Copy the style of an existing audio |\n| `artist_consistency` | Generate in a custom singer's style |\n| `artist_consistency_vox` | Artist consistency with vocal focus |\n| `stems` | Separate a track into stems |\n| `all_stems` | Separate into all available stems |\n| `replace_section` | Replace a specific time range in a song |\n| `underpainting` | Add accompaniment to an uploaded song |\n| `overpainting` | Add vocals to an uploaded song |\n| `remaster` | Remaster an existing audio |\n| `mashup` | Blend multiple audio IDs together |\n| `samples` | Add samples to an uploaded song |\n\n## Auxiliary Endpoints\n\n| Endpoint | Method | Purpose |\n|----------|--------|---------|\n| `/suno/lyrics` | POST | Generate structured lyrics from a prompt (`model`: `\"default\"` or `\"remi-v1\"`) |\n| `/suno/style` | POST | Optimize/refine a style description |\n| `/suno/mashup-lyrics` | POST | Combine two sets of lyrics |\n| `/suno/mp4` | POST | Get MP4 video version of a song |\n| `/suno/wav` | POST | Convert to lossless WAV format |\n| `/suno/midi` | POST | Extract MIDI data for DAW editing |\n| `/suno/vox` | POST | Extract vocal track (stem separation) |\n| `/suno/timing` | POST | Get word-level timing/subtitles |\n| `/suno/persona` | POST | Save a vocal style as a reusable persona |\n| `/suno/upload` | POST | Upload external audio for extend/cover |\n| `/suno/tasks` | POST | Query task status and results |\n\n## Advanced Parameters\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| `lyric_prompt` | string | Prompt for auto-generating lyrics (used when `custom: true` without explicit `lyric`) |\n| `style_negative` | string | Style tags to avoid (e.g., `\"heavy metal, distortion\"`) |\n| `style_influence` | number | Strength of style influence (advanced custom mode, v5+ only) |\n| `audio_weight` | number | Weight for audio reference when covering (advanced, v5+ only) |\n\n## Lyrics Format\n\nUse section markers in square brackets:\n\n```\n[Verse 1]\nYour verse lyrics here\n\n[Chorus]\nCatchy chorus lyrics\n\n[Bridge]\nBridge section\n\n[Outro]\nEnding lyrics\n```\n\n## Gotchas\n\n- All generation is **async** — always set `\"callback_url\"` to get a `task_id` immediately, then poll `/suno/tasks`\n- **CRITICAL:** Check the `state` field — 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\n- Lyrics max ~3000 characters. For longer songs, use the **extend** workflow\n- Style tags are descriptive phrases, not enum values (e.g., \"Synthwave, Electronic, Dreamy\")\n- `vocal_gender` (\"f\"/\"m\") is only supported on v4.5+ models\n- `variation_category` (\"high\"/\"normal\"/\"subtle\") is only supported on v5+ models\n- The `concat` action merges extended song segments — requires audio_id of the extended track\n- `persona` requires an existing audio_id to extract the vocal reference from\n- Upload external audio via `/suno/upload` before using it with extend/cover\n\n> **MCP:** `pip install mcp-suno` | Hosted: `https://suno.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)","tags":["suno","music","skills","acedatacloud","acedata-cloud","agent-skills","agentskills","ai-image","ai-music","ai-tools","ai-video","claude-code"],"capabilities":["skill","source-acedatacloud","skill-suno-music","topic-acedata-cloud","topic-agent-skills","topic-agentskills","topic-ai-image","topic-ai-music","topic-ai-tools","topic-ai-video","topic-claude-code","topic-cursor","topic-gemini-cli","topic-github-copilot","topic-mcp"],"categories":["Skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/AceDataCloud/Skills/suno-music","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add AceDataCloud/Skills","source_repo":"https://github.com/AceDataCloud/Skills","install_from":"skills.sh"}},"qualityScore":"0.453","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 7 github stars · SKILL.md body (6,241 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:14:04.011Z","embedding":null,"createdAt":"2026-05-18T13:21:35.109Z","updatedAt":"2026-05-18T19:14:04.011Z","lastSeenAt":"2026-05-18T19:14:04.011Z","tsv":"'-5':123 '/_shared/async-tasks.md':113 '/_shared/authentication.md':62 '/_shared/mcp-servers.md':863 '/health':103 '/mcp':858 '/suno/audios':74,198,233,282,322,370 '/suno/lyrics':353,545 '/suno/mashup-lyrics':565 '/suno/midi':415,588 '/suno/mp4':418,572 '/suno/persona':610 '/suno/style':361,559 '/suno/tasks':117,380,627,731 '/suno/timing':603 '/suno/upload':620,843 '/suno/vox':596 '/suno/wav':413,581 '0':173 '1':177,349,699 '120.0':299 '2':216,357 '3':122,265,366 '3000':771 '4':305,376 '5':98,133,145,152,167,213,261,335,388 '6':398 '7':408 'accompani':510 'acedatacloud':10,55,78 'acoust':333 'action':283,323,373,393,403,420,421,815 'add':395,509,516,534 'advanc':634,673,687 'ai':5,51,208 'ai-pow':50 'alway':719 'api':11,58,79,748 'api.acedata.cloud':73,102 'api.acedata.cloud/health':101 'api.acedata.cloud/suno/audios':72 'application/json':85 'artist':468,477,480 'async':104,108,110,718 'audio':285,289,325,329,432,440,448,467,526,530,624,678,683,752,763,821,831,841 'authent':61 'author':76 'auto':645 'auto-gener':644 'automat':195 'auxiliari':540 'avail':125,419,496 'avoid':661 'balanc':154 'bash':68 'bearer':77 'best':128,341 'blend':528 'bracket':697 'bridg':292,708,709 'build':246 'callback':99,721 'catchi':705 'categori':803 'charact':772 'check':733 'chirp':96,131,138,143,150,160,165,171,211,259 'chirp-v3':164,170 'chirp-v4':142,149,159 'chirp-v5':95,130,137,210,258 'chorus':244,704,706 'code':93 'combin':567 'complet':387,739 'concat':400,402,453,814 'concaten':454 'consist':469,478,481 'content':83 'content-typ':82 'continu':269,297,429 'control':220,230 'convert':410,583 'copi':461 'core':175 'cover':24,306,324,445,452,460,686 'creat':14,23,190,308,450 'creation':338 'critic':732 'curl':69 'custom':40,217,234,372,473,650,674 'd':86 'data':592 'daw':594 'default':427,554 'descript':188,365,422,564,638,783 'differ':318 'digit':251 'distort':665 'done':744 'dream':252 'dreami':256,791 'e.g':662,788 'edit':595 'electron':202,255,790 'empti':768 'end':712 'endpoint':541,542 'enhanc':147 'enum':786 'everi':121 'exist':271,288,314,328,431,466,525,830 'existing-audio-id':287,327 'explicit':653 'extend':21,266,284,390,392,406,428,437,442,455,778,817,825 'extend/cover':626,848 'extern':439,447,623,840 'extract':25,590,598,834 'f':264,794 'fals':215 'fast':162 'field':736 'focus':484 'follow':343 'format':44,587,691 'full':219,336 'futur':206,248 'gender':263,793 'generat':4,19,33,48,49,106,179,182,218,350,367,423,424,470,547,646,716 'get':411,574,605,724 'good':153 'gotcha':714 'h':75,81 'happi':89 'heavi':663 'high':140,804 'highest':135 'host':855 'id':120,286,290,326,330,383,531,727,822,832 'immedi':728 'influenc':667,672 'inspir':180 'instal':851 'instrument':214 'intermedi':751 'jazz':332 'json':196,231,280,320 'latest':134 'legaci':168,174 'level':608 'longer':774 'lossless':585 'lyric':20,191,224,236,279,291,295,351,374,549,571,639,647,654,690,702,707,713,769 'm':795 'manag':27 'marker':694 'mashup':527 'max':770 'may':749 'mcp':849,853,861 'mcp-suno':852 'mean':743 'mellow':334 'merg':405,816 'metal':664 'method':543 'midi':414,591 'mode':181,675 'model':94,126,127,209,257,553,801,812 'motion':242 'mp4':417,575 'multi':43,346 'multi-format':42 'multi-step':345 'multipl':529 'music':3,6,32,39,47,53,194,368 'n':243 'ncode':238 'negat':656 'new':278,310 'nnew':293 'non':767 'non-empti':766 'normal':805 'number':668,680 'nwe':245 'one':458 'optim':358 'optimize/refine':561 'option':389,399,409 'origin':304 'output':45 'outro':711 'overpaint':515 'paramet':635,636 'pend':746 'persona':29,619,827 'phrase':784 'pip':850 'plus':146 'poetri':240 'poll':112,114,377,730,760 'pop':90 'post':71,116,197,232,281,321,352,360,369,379,546,560,566,573,582,589,597,604,611,621,628 'power':52 'precis':229 'preview':756 'prompt':18,87,199,426,552,640,642 'provid':221 'purpos':544 'qualiti':136,141,156 'queri':629 'quick':66,178 'rang':504 'refer':684,837 'refin':363 'reliabl':163 'remast':522,523 'remi':557 'remi-v1':556 'remix':307 'replac':498,500 'requir':820,828 'result':342,633 'return':750 'reusabl':618 'sampl':533,535 'save':612 'second':124 'section':294,397,499,693,710 'see':60,109,859 'segment':407,456,819 'separ':486,493,602 'server':862 'set':569,720 'setup':59,65 'singer':474 'skill' 'skill-suno-music' 'song':15,91,184,268,272,315,337,507,514,521,539,580,775,818 'source-acedatacloud' 'specif':275,502 'speed':158 'squar':696 'stabl':169 'start':67 'state':735,738 'status':385,631 'stem':485,490,492,497,601 'step':347 'stop':759 'stream':755 'strength':669 'string':641,657 'structur':548 'style':41,192,227,253,300,302,319,331,359,364,375,463,476,563,615,655,658,666,671,780 'subtl':806 'success':741 'suno':2,8,46,57,189,854 'suno-mus':1 'suno.mcp.acedata.cloud':857 'suno.mcp.acedata.cloud/mcp':856 'support':35,798,809 'synthwav':254,789 'tag':659,781 'task':34,111,119,378,382,630,726 'text':17,37,187 'text-to-mus':36 'time':503 'timestamp':276,435 'timing/subtitles':609 'titl':225,250 'togeth':532 'token':64,80 'tonight':249 'topic-acedata-cloud' 'topic-agent-skills' 'topic-agentskills' 'topic-ai-image' 'topic-ai-music' 'topic-ai-tools' 'topic-ai-video' 'topic-claude-code' 'topic-cursor' 'topic-gemini-cli' 'topic-github-copilot' 'topic-mcp' 'topic/prompt':356 'track':22,203,459,488,600,826 'true':235,651,742 'two':568 'type':84,637 'underpaint':508 'upbeat':201 'upload':436,438,444,446,513,520,538,622,839 'url':100,722,753,764 'use':12,391,401,648,692,776,845 'v1':558 'v3':166,172 'v4':144,151,161 'v4.5':148,800 'v5':97,132,139,212,260,676,688,811 'valu':754,787 'variat':802 'vers':237,698,701 'version':311,577 'via':9,115,842 'video':576 'vocal':26,262,483,517,599,614,792,836 'voic':28 'vox':479 'wav':412,586 'weight':679,681 'without':652 'word':607 'word-level':606 'workflow':176,339,348,779 'x':70","prices":[{"id":"9b1b1da4-4ea2-471f-8a6f-861d55e06825","listingId":"d489787f-9c89-4115-8348-2a66ff540d84","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"AceDataCloud","category":"Skills","install_from":"skills.sh"},"createdAt":"2026-05-18T13:21:35.109Z"}],"sources":[{"listingId":"d489787f-9c89-4115-8348-2a66ff540d84","source":"github","sourceId":"AceDataCloud/Skills/suno-music","sourceUrl":"https://github.com/AceDataCloud/Skills/tree/main/skills/suno-music","isPrimary":false,"firstSeenAt":"2026-05-18T13:21:35.109Z","lastSeenAt":"2026-05-18T19:14:04.011Z"}],"details":{"listingId":"d489787f-9c89-4115-8348-2a66ff540d84","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"AceDataCloud","slug":"suno-music","github":{"repo":"AceDataCloud/Skills","stars":7,"topics":["acedata-cloud","agent-skills","agentskills","ai-image","ai-music","ai-tools","ai-video","claude-code","cursor","gemini-cli","github-copilot","mcp","npm","openai-codex","roo-code"],"license":"other","html_url":"https://github.com/AceDataCloud/Skills","pushed_at":"2026-05-18T07:35:03Z","description":"Agent Skills for AceDataCloud AI services — music, image, video generation, web search, and more. Compatible with Claude Code, GitHub Copilot, Gemini CLI, and all agentskills.io-compatible agents.","skill_md_sha":"be97c26056f15be7c309b8d59109256bad532f63","skill_md_path":"skills/suno-music/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/AceDataCloud/Skills/tree/main/skills/suno-music"},"layout":"multi","source":"github","category":"Skills","frontmatter":{"name":"suno-music","license":"Apache-2.0","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.","compatibility":"Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-suno for tool-use."},"skills_sh_url":"https://skills.sh/AceDataCloud/Skills/suno-music"},"updatedAt":"2026-05-18T19:14:04.011Z"}}