{
  "schemaVersion": "1.0",
  "item": {
    "slug": "ace-music",
    "name": "ACE Music - Free Suno Alternative Generate unlimited AI music for free using ACE-Step 1.5. Full songs with vocals, lyrics, any genre, any language. No subscription, no credits, no limits. The open-source Suno alternative, powered by ACE Music's free API.",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/fspecii/ace-music",
    "canonicalUrl": "https://clawhub.ai/fspecii/ace-music",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/ace-music",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ace-music",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "references/api-docs.md",
      "scripts/generate.sh",
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/ace-music"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/ace-music",
    "agentPageUrl": "https://openagent3.xyz/skills/ace-music/agent",
    "manifestUrl": "https://openagent3.xyz/skills/ace-music/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/ace-music/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "ACE Music - AI Music Generation",
        "body": "Generate music via ACE Music's free hosted API (ACE-Step 1.5 model)."
      },
      {
        "title": "Setup",
        "body": "API Key is stored in env ACE_MUSIC_API_KEY. If not set:\n\nOpen https://acemusic.ai/playground/api-key in the browser for the user\nAsk them to sign up (free) and paste the API key\nStore it: export ACE_MUSIC_API_KEY=<key> or add to TOOLS.md"
      },
      {
        "title": "Quick Generation",
        "body": "Use scripts/generate.sh for one-shot generation:\n\n# Simple prompt (AI decides everything)\nscripts/generate.sh \"upbeat pop song about summer\" --duration 30 --output summer.mp3\n\n# With lyrics\nscripts/generate.sh \"gentle acoustic ballad, female vocal\" \\\n  --lyrics \"[Verse 1]\\nSunlight through the window\\n\\n[Chorus]\\nWe are the dreamers\" \\\n  --duration 60 --output ballad.mp3\n\n# Instrumental only\nscripts/generate.sh \"lo-fi hip hop beats, chill, rainy day\" --instrumental --duration 120 --output lofi.mp3\n\n# Natural language (AI writes everything)\nscripts/generate.sh \"write me a jazz song about coffee\" --sample-mode --output jazz.mp3\n\n# Specific settings\nscripts/generate.sh \"rock anthem\" --bpm 140 --key \"E minor\" --language en --seed 42 --output rock.mp3\n\n# Multiple variations\nscripts/generate.sh \"electronic dance track\" --batch 3 --output edm.mp3\n\nScript outputs file path(s) to stdout. Send the file to the user."
      },
      {
        "title": "Advanced Usage (curl/direct API)",
        "body": "For covers, repainting, or audio input — see references/api-docs.md for full API spec.\n\nKey task types:\n\ntext2music (default) — generate from text/lyrics\ncover — cover an existing song (requires audio input)\nrepaint — modify a section of existing audio"
      },
      {
        "title": "Parameters Guide",
        "body": "WantUseSpecific styleDescribe in prompt: \"jazz, saxophone solo, smoky bar\"Custom lyrics--lyrics \"[Verse]...[Chorus]...\"AI writes everything--sample-modeNo vocals--instrumentalLonger songs--duration 120 (seconds)Specific tempo--bpm 120Specific key--key \"C major\"Multiple outputs--batch 3Reproducible--seed 42Non-English vocals--language ja (zh, en, ja, ko, etc.)"
      },
      {
        "title": "Notes",
        "body": "API is free forever (confirmed by ACE Music team)\nBase URL: https://api.acemusic.ai\nAudio returned as base64 MP3, decoded automatically by the script\nDuration: if omitted, AI decides based on content\nFor best results, use tagged mode (prompt + lyrics separated)"
      }
    ],
    "body": "ACE Music - AI Music Generation\n\nGenerate music via ACE Music's free hosted API (ACE-Step 1.5 model).\n\nSetup\n\nAPI Key is stored in env ACE_MUSIC_API_KEY. If not set:\n\nOpen https://acemusic.ai/playground/api-key in the browser for the user\nAsk them to sign up (free) and paste the API key\nStore it: export ACE_MUSIC_API_KEY=<key> or add to TOOLS.md\nQuick Generation\n\nUse scripts/generate.sh for one-shot generation:\n\n# Simple prompt (AI decides everything)\nscripts/generate.sh \"upbeat pop song about summer\" --duration 30 --output summer.mp3\n\n# With lyrics\nscripts/generate.sh \"gentle acoustic ballad, female vocal\" \\\n  --lyrics \"[Verse 1]\\nSunlight through the window\\n\\n[Chorus]\\nWe are the dreamers\" \\\n  --duration 60 --output ballad.mp3\n\n# Instrumental only\nscripts/generate.sh \"lo-fi hip hop beats, chill, rainy day\" --instrumental --duration 120 --output lofi.mp3\n\n# Natural language (AI writes everything)\nscripts/generate.sh \"write me a jazz song about coffee\" --sample-mode --output jazz.mp3\n\n# Specific settings\nscripts/generate.sh \"rock anthem\" --bpm 140 --key \"E minor\" --language en --seed 42 --output rock.mp3\n\n# Multiple variations\nscripts/generate.sh \"electronic dance track\" --batch 3 --output edm.mp3\n\n\nScript outputs file path(s) to stdout. Send the file to the user.\n\nAdvanced Usage (curl/direct API)\n\nFor covers, repainting, or audio input — see references/api-docs.md for full API spec.\n\nKey task types:\n\ntext2music (default) — generate from text/lyrics\ncover — cover an existing song (requires audio input)\nrepaint — modify a section of existing audio\nParameters Guide\nWant\tUse\nSpecific style\tDescribe in prompt: \"jazz, saxophone solo, smoky bar\"\nCustom lyrics\t--lyrics \"[Verse]...[Chorus]...\"\nAI writes everything\t--sample-mode\nNo vocals\t--instrumental\nLonger songs\t--duration 120 (seconds)\nSpecific tempo\t--bpm 120\nSpecific key\t--key \"C major\"\nMultiple outputs\t--batch 3\nReproducible\t--seed 42\nNon-English vocals\t--language ja (zh, en, ja, ko, etc.)\nNotes\nAPI is free forever (confirmed by ACE Music team)\nBase URL: https://api.acemusic.ai\nAudio returned as base64 MP3, decoded automatically by the script\nDuration: if omitted, AI decides based on content\nFor best results, use tagged mode (prompt + lyrics separated)"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/fspecii/ace-music",
    "publisherUrl": "https://clawhub.ai/fspecii/ace-music",
    "owner": "fspecii",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/ace-music",
    "downloadUrl": "https://openagent3.xyz/downloads/ace-music",
    "agentUrl": "https://openagent3.xyz/skills/ace-music/agent",
    "manifestUrl": "https://openagent3.xyz/skills/ace-music/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/ace-music/agent.md"
  }
}