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 | Default |
---|---|---|---|
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"
}