generate_music_suno

Create custom songs by providing lyrics, style, and title, or generate music from a description. Returns an audio URL in HTML format for easy playback and download, accessible through the Suno API on the Suno-MCP server.

Instructions

Generates a song using the Suno API. Provide lyrics, style, and title for custom mode, or a description for inspiration mode. Returns the audio URL upon completion. Polling for results may take a few minutes.

When returning an audio URL, please use the following HTML format for user convenience:

<audio controls>
  <source src="YOUR_AUDIO_URL_HERE" type="audio/mpeg">
</audio>
<br>
<a href="YOUR_AUDIO_URL_HERE" download="SONG_TITLE.mp3">
  点击这里下载喵！
</a>

Input Schema

Name	Required	Description
`continue_at`	No	Optional. Time in seconds from which to continue the song. Requires 'task_id' and 'continue_clip_id'.
`continue_clip_id`	No	Optional. Clip ID of the song part to continue. Requires 'task_id' and 'continue_at'.
`gpt_description_prompt`	No	Optional. Description for inspiration mode. If provided, 'prompt', 'tags', and 'title' are not strictly required by the user but might be used by the API. Example: 'A cheerful upbeat song about a sunny day.'
`make_instrumental`	No	Optional. Whether to generate instrumental music. Defaults to false.
`mv`	No	Optional. Model version. Defaults to 'chirp-v4'.
`prompt`	No	Lyrics content. Required for custom mode. Example: '[Verse 1]\nUnder the starry sky...'
`tags`	No	Music style tags, comma-separated. Required for custom mode. Example: 'acoustic, folk, pop'
`task_id`	No	Optional. Task ID of a previous song to continue. If provided, 'continue_at' and 'continue_clip_id' are also required.
`title`	No	Song title. Required for custom mode. Example: 'Starry Night Serenade'

Input Schema (JSON Schema)

{
  "properties": {
    "continue_at": {
      "description": "Optional. Time in seconds from which to continue the song. Requires 'task_id' and 'continue_clip_id'.",
      "type": "number"
    },
    "continue_clip_id": {
      "description": "Optional. Clip ID of the song part to continue. Requires 'task_id' and 'continue_at'.",
      "type": "string"
    },
    "gpt_description_prompt": {
      "description": "Optional. Description for inspiration mode. If provided, 'prompt', 'tags', and 'title' are not strictly required by the user but might be used by the API. Example: 'A cheerful upbeat song about a sunny day.'",
      "type": "string"
    },
    "make_instrumental": {
      "description": "Optional. Whether to generate instrumental music. Defaults to false.",
      "type": "boolean"
    },
    "mv": {
      "description": "Optional. Model version. Defaults to 'chirp-v4'.",
      "enum": [
        "chirp-v3-0",
        "chirp-v3-5",
        "chirp-v4"
      ],
      "type": "string"
    },
    "prompt": {
      "description": "Lyrics content. Required for custom mode. Example: '[Verse 1]\\nUnder the starry sky...' ",
      "type": "string"
    },
    "tags": {
      "description": "Music style tags, comma-separated. Required for custom mode. Example: 'acoustic, folk, pop'",
      "type": "string"
    },
    "task_id": {
      "description": "Optional. Task ID of a previous song to continue. If provided, 'continue_at' and 'continue_clip_id' are also required.",
      "type": "string"
    },
    "title": {
      "description": "Song title. Required for custom mode. Example: 'Starry Night Serenade'",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Suno-MCP