Generate Music - MountSea API

cURL

curl --request POST \
  --url https://api.mountsea.ai/suno/v2/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "task": "create",
  "model": "chirp-v50",
  "make_instrumental": false,
  "prompt": "[Verse]\nHello world, here I come...\n\n[Chorus]\nLa la la...",
  "continued_aligned_prompt": "[Verse 1]\nOriginal lyrics...\n\n[Chorus]\nNew replaced lyrics...\n\n[Verse 2]\nMore lyrics...",
  "infill_lyrics": "[Bridge]\nThis is the new bridge section\nWith updated lyrics...",
  "gpt_description_prompt": "A happy pop song about summer vacation",
  "tags": "Pop, Happy, Upbeat",
  "negative_tags": "Sad, Slow",
  "title": "Summer Vibes",
  "clip_id": "clip_abc123",
  "continue_at": 30,
  "range": {
    "start_s": 15.36,
    "end_s": 53.8
  },
  "infill_type": "smart",
  "infill_context_range": {
    "start_s": 0,
    "end_s": 69.16
  },
  "persona": {
    "persona_id": "persona_xyz789",
    "artist_clip_id": "clip_abc123",
    "persona_style": "vox"
  },
  "controls": {
    "style_weight": 0.6,
    "audio_weight": 0.4,
    "weirdness_constraint": 0.2,
    "duration": 120
  },
  "vocal_gender": "m",
  "audio_url": "https://example.com/audio.mp3",
  "mashup_clip_ids": [
    "clip_abc123",
    "clip_def456"
  ],
  "playlist_id": "119573ff-8e48-4fe6-9029-39c76c9a5597",
  "sound": {
    "description": "深沉的低音和温暖的模拟质感",
    "type": "one_shot",
    "key": "F#",
    "bpm": 2
  },
  "stem_control_tags": "add "
}
'

import requests

url = "https://api.mountsea.ai/suno/v2/generate"

payload = {
    "task": "create",
    "model": "chirp-v50",
    "make_instrumental": False,
    "prompt": "[Verse]
Hello world, here I come...

[Chorus]
La la la...",
    "continued_aligned_prompt": "[Verse 1]
Original lyrics...

[Chorus]
New replaced lyrics...

[Verse 2]
More lyrics...",
    "infill_lyrics": "[Bridge]
This is the new bridge section
With updated lyrics...",
    "gpt_description_prompt": "A happy pop song about summer vacation",
    "tags": "Pop, Happy, Upbeat",
    "negative_tags": "Sad, Slow",
    "title": "Summer Vibes",
    "clip_id": "clip_abc123",
    "continue_at": 30,
    "range": {
        "start_s": 15.36,
        "end_s": 53.8
    },
    "infill_type": "smart",
    "infill_context_range": {
        "start_s": 0,
        "end_s": 69.16
    },
    "persona": {
        "persona_id": "persona_xyz789",
        "artist_clip_id": "clip_abc123",
        "persona_style": "vox"
    },
    "controls": {
        "style_weight": 0.6,
        "audio_weight": 0.4,
        "weirdness_constraint": 0.2,
        "duration": 120
    },
    "vocal_gender": "m",
    "audio_url": "https://example.com/audio.mp3",
    "mashup_clip_ids": ["clip_abc123", "clip_def456"],
    "playlist_id": "119573ff-8e48-4fe6-9029-39c76c9a5597",
    "sound": {
        "description": "深沉的低音和温暖的模拟质感",
        "type": "one_shot",
        "key": "F#",
        "bpm": 2
    },
    "stem_control_tags": "add "
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    task: 'create',
    model: 'chirp-v50',
    make_instrumental: false,
    prompt: '[Verse]\nHello world, here I come...\n\n[Chorus]\nLa la la...',
    continued_aligned_prompt: '[Verse 1]\nOriginal lyrics...\n\n[Chorus]\nNew replaced lyrics...\n\n[Verse 2]\nMore lyrics...',
    infill_lyrics: '[Bridge]\nThis is the new bridge section\nWith updated lyrics...',
    gpt_description_prompt: 'A happy pop song about summer vacation',
    tags: 'Pop, Happy, Upbeat',
    negative_tags: 'Sad, Slow',
    title: 'Summer Vibes',
    clip_id: 'clip_abc123',
    continue_at: 30,
    range: {start_s: 15.36, end_s: 53.8},
    infill_type: 'smart',
    infill_context_range: {start_s: 0, end_s: 69.16},
    persona: {
      persona_id: 'persona_xyz789',
      artist_clip_id: 'clip_abc123',
      persona_style: 'vox'
    },
    controls: {style_weight: 0.6, audio_weight: 0.4, weirdness_constraint: 0.2, duration: 120},
    vocal_gender: 'm',
    audio_url: 'https://example.com/audio.mp3',
    mashup_clip_ids: ['clip_abc123', 'clip_def456'],
    playlist_id: '119573ff-8e48-4fe6-9029-39c76c9a5597',
    sound: {description: '深沉的低音和温暖的模拟质感', type: 'one_shot', key: 'F#', bpm: 2},
    stem_control_tags: 'add '
  })
};

fetch('https://api.mountsea.ai/suno/v2/generate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.mountsea.ai/suno/v2/generate",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'task' => 'create',
    'model' => 'chirp-v50',
    'make_instrumental' => false,
    'prompt' => '[Verse]
Hello world, here I come...

[Chorus]
La la la...',
    'continued_aligned_prompt' => '[Verse 1]
Original lyrics...

[Chorus]
New replaced lyrics...

[Verse 2]
More lyrics...',
    'infill_lyrics' => '[Bridge]
This is the new bridge section
With updated lyrics...',
    'gpt_description_prompt' => 'A happy pop song about summer vacation',
    'tags' => 'Pop, Happy, Upbeat',
    'negative_tags' => 'Sad, Slow',
    'title' => 'Summer Vibes',
    'clip_id' => 'clip_abc123',
    'continue_at' => 30,
    'range' => [
        'start_s' => 15.36,
        'end_s' => 53.8
    ],
    'infill_type' => 'smart',
    'infill_context_range' => [
        'start_s' => 0,
        'end_s' => 69.16
    ],
    'persona' => [
        'persona_id' => 'persona_xyz789',
        'artist_clip_id' => 'clip_abc123',
        'persona_style' => 'vox'
    ],
    'controls' => [
        'style_weight' => 0.6,
        'audio_weight' => 0.4,
        'weirdness_constraint' => 0.2,
        'duration' => 120
    ],
    'vocal_gender' => 'm',
    'audio_url' => 'https://example.com/audio.mp3',
    'mashup_clip_ids' => [
        'clip_abc123',
        'clip_def456'
    ],
    'playlist_id' => '119573ff-8e48-4fe6-9029-39c76c9a5597',
    'sound' => [
        'description' => '深沉的低音和温暖的模拟质感',
        'type' => 'one_shot',
        'key' => 'F#',
        'bpm' => 2
    ],
    'stem_control_tags' => 'add '
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.mountsea.ai/suno/v2/generate"

	payload := strings.NewReader("{\n  \"task\": \"create\",\n  \"model\": \"chirp-v50\",\n  \"make_instrumental\": false,\n  \"prompt\": \"[Verse]\\nHello world, here I come...\\n\\n[Chorus]\\nLa la la...\",\n  \"continued_aligned_prompt\": \"[Verse 1]\\nOriginal lyrics...\\n\\n[Chorus]\\nNew replaced lyrics...\\n\\n[Verse 2]\\nMore lyrics...\",\n  \"infill_lyrics\": \"[Bridge]\\nThis is the new bridge section\\nWith updated lyrics...\",\n  \"gpt_description_prompt\": \"A happy pop song about summer vacation\",\n  \"tags\": \"Pop, Happy, Upbeat\",\n  \"negative_tags\": \"Sad, Slow\",\n  \"title\": \"Summer Vibes\",\n  \"clip_id\": \"clip_abc123\",\n  \"continue_at\": 30,\n  \"range\": {\n    \"start_s\": 15.36,\n    \"end_s\": 53.8\n  },\n  \"infill_type\": \"smart\",\n  \"infill_context_range\": {\n    \"start_s\": 0,\n    \"end_s\": 69.16\n  },\n  \"persona\": {\n    \"persona_id\": \"persona_xyz789\",\n    \"artist_clip_id\": \"clip_abc123\",\n    \"persona_style\": \"vox\"\n  },\n  \"controls\": {\n    \"style_weight\": 0.6,\n    \"audio_weight\": 0.4,\n    \"weirdness_constraint\": 0.2,\n    \"duration\": 120\n  },\n  \"vocal_gender\": \"m\",\n  \"audio_url\": \"https://example.com/audio.mp3\",\n  \"mashup_clip_ids\": [\n    \"clip_abc123\",\n    \"clip_def456\"\n  ],\n  \"playlist_id\": \"119573ff-8e48-4fe6-9029-39c76c9a5597\",\n  \"sound\": {\n    \"description\": \"深沉的低音和温暖的模拟质感\",\n    \"type\": \"one_shot\",\n    \"key\": \"F#\",\n    \"bpm\": 2\n  },\n  \"stem_control_tags\": \"add \"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.mountsea.ai/suno/v2/generate")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"task\": \"create\",\n  \"model\": \"chirp-v50\",\n  \"make_instrumental\": false,\n  \"prompt\": \"[Verse]\\nHello world, here I come...\\n\\n[Chorus]\\nLa la la...\",\n  \"continued_aligned_prompt\": \"[Verse 1]\\nOriginal lyrics...\\n\\n[Chorus]\\nNew replaced lyrics...\\n\\n[Verse 2]\\nMore lyrics...\",\n  \"infill_lyrics\": \"[Bridge]\\nThis is the new bridge section\\nWith updated lyrics...\",\n  \"gpt_description_prompt\": \"A happy pop song about summer vacation\",\n  \"tags\": \"Pop, Happy, Upbeat\",\n  \"negative_tags\": \"Sad, Slow\",\n  \"title\": \"Summer Vibes\",\n  \"clip_id\": \"clip_abc123\",\n  \"continue_at\": 30,\n  \"range\": {\n    \"start_s\": 15.36,\n    \"end_s\": 53.8\n  },\n  \"infill_type\": \"smart\",\n  \"infill_context_range\": {\n    \"start_s\": 0,\n    \"end_s\": 69.16\n  },\n  \"persona\": {\n    \"persona_id\": \"persona_xyz789\",\n    \"artist_clip_id\": \"clip_abc123\",\n    \"persona_style\": \"vox\"\n  },\n  \"controls\": {\n    \"style_weight\": 0.6,\n    \"audio_weight\": 0.4,\n    \"weirdness_constraint\": 0.2,\n    \"duration\": 120\n  },\n  \"vocal_gender\": \"m\",\n  \"audio_url\": \"https://example.com/audio.mp3\",\n  \"mashup_clip_ids\": [\n    \"clip_abc123\",\n    \"clip_def456\"\n  ],\n  \"playlist_id\": \"119573ff-8e48-4fe6-9029-39c76c9a5597\",\n  \"sound\": {\n    \"description\": \"深沉的低音和温暖的模拟质感\",\n    \"type\": \"one_shot\",\n    \"key\": \"F#\",\n    \"bpm\": 2\n  },\n  \"stem_control_tags\": \"add \"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.mountsea.ai/suno/v2/generate")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"task\": \"create\",\n  \"model\": \"chirp-v50\",\n  \"make_instrumental\": false,\n  \"prompt\": \"[Verse]\\nHello world, here I come...\\n\\n[Chorus]\\nLa la la...\",\n  \"continued_aligned_prompt\": \"[Verse 1]\\nOriginal lyrics...\\n\\n[Chorus]\\nNew replaced lyrics...\\n\\n[Verse 2]\\nMore lyrics...\",\n  \"infill_lyrics\": \"[Bridge]\\nThis is the new bridge section\\nWith updated lyrics...\",\n  \"gpt_description_prompt\": \"A happy pop song about summer vacation\",\n  \"tags\": \"Pop, Happy, Upbeat\",\n  \"negative_tags\": \"Sad, Slow\",\n  \"title\": \"Summer Vibes\",\n  \"clip_id\": \"clip_abc123\",\n  \"continue_at\": 30,\n  \"range\": {\n    \"start_s\": 15.36,\n    \"end_s\": 53.8\n  },\n  \"infill_type\": \"smart\",\n  \"infill_context_range\": {\n    \"start_s\": 0,\n    \"end_s\": 69.16\n  },\n  \"persona\": {\n    \"persona_id\": \"persona_xyz789\",\n    \"artist_clip_id\": \"clip_abc123\",\n    \"persona_style\": \"vox\"\n  },\n  \"controls\": {\n    \"style_weight\": 0.6,\n    \"audio_weight\": 0.4,\n    \"weirdness_constraint\": 0.2,\n    \"duration\": 120\n  },\n  \"vocal_gender\": \"m\",\n  \"audio_url\": \"https://example.com/audio.mp3\",\n  \"mashup_clip_ids\": [\n    \"clip_abc123\",\n    \"clip_def456\"\n  ],\n  \"playlist_id\": \"119573ff-8e48-4fe6-9029-39c76c9a5597\",\n  \"sound\": {\n    \"description\": \"深沉的低音和温暖的模拟质感\",\n    \"type\": \"one_shot\",\n    \"key\": \"F#\",\n    \"bpm\": 2\n  },\n  \"stem_control_tags\": \"add \"\n}"

response = http.request(request)
puts response.read_body

{
  "taskId": "15c257ff-43f7-4678-bd41-202ad6b8488b"
}

POST

suno

generate

cURL

curl --request POST \
  --url https://api.mountsea.ai/suno/v2/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "task": "create",
  "model": "chirp-v50",
  "make_instrumental": false,
  "prompt": "[Verse]\nHello world, here I come...\n\n[Chorus]\nLa la la...",
  "continued_aligned_prompt": "[Verse 1]\nOriginal lyrics...\n\n[Chorus]\nNew replaced lyrics...\n\n[Verse 2]\nMore lyrics...",
  "infill_lyrics": "[Bridge]\nThis is the new bridge section\nWith updated lyrics...",
  "gpt_description_prompt": "A happy pop song about summer vacation",
  "tags": "Pop, Happy, Upbeat",
  "negative_tags": "Sad, Slow",
  "title": "Summer Vibes",
  "clip_id": "clip_abc123",
  "continue_at": 30,
  "range": {
    "start_s": 15.36,
    "end_s": 53.8
  },
  "infill_type": "smart",
  "infill_context_range": {
    "start_s": 0,
    "end_s": 69.16
  },
  "persona": {
    "persona_id": "persona_xyz789",
    "artist_clip_id": "clip_abc123",
    "persona_style": "vox"
  },
  "controls": {
    "style_weight": 0.6,
    "audio_weight": 0.4,
    "weirdness_constraint": 0.2,
    "duration": 120
  },
  "vocal_gender": "m",
  "audio_url": "https://example.com/audio.mp3",
  "mashup_clip_ids": [
    "clip_abc123",
    "clip_def456"
  ],
  "playlist_id": "119573ff-8e48-4fe6-9029-39c76c9a5597",
  "sound": {
    "description": "深沉的低音和温暖的模拟质感",
    "type": "one_shot",
    "key": "F#",
    "bpm": 2
  },
  "stem_control_tags": "add "
}
'

import requests

url = "https://api.mountsea.ai/suno/v2/generate"

payload = {
    "task": "create",
    "model": "chirp-v50",
    "make_instrumental": False,
    "prompt": "[Verse]
Hello world, here I come...

[Chorus]
La la la...",
    "continued_aligned_prompt": "[Verse 1]
Original lyrics...

[Chorus]
New replaced lyrics...

[Verse 2]
More lyrics...",
    "infill_lyrics": "[Bridge]
This is the new bridge section
With updated lyrics...",
    "gpt_description_prompt": "A happy pop song about summer vacation",
    "tags": "Pop, Happy, Upbeat",
    "negative_tags": "Sad, Slow",
    "title": "Summer Vibes",
    "clip_id": "clip_abc123",
    "continue_at": 30,
    "range": {
        "start_s": 15.36,
        "end_s": 53.8
    },
    "infill_type": "smart",
    "infill_context_range": {
        "start_s": 0,
        "end_s": 69.16
    },
    "persona": {
        "persona_id": "persona_xyz789",
        "artist_clip_id": "clip_abc123",
        "persona_style": "vox"
    },
    "controls": {
        "style_weight": 0.6,
        "audio_weight": 0.4,
        "weirdness_constraint": 0.2,
        "duration": 120
    },
    "vocal_gender": "m",
    "audio_url": "https://example.com/audio.mp3",
    "mashup_clip_ids": ["clip_abc123", "clip_def456"],
    "playlist_id": "119573ff-8e48-4fe6-9029-39c76c9a5597",
    "sound": {
        "description": "深沉的低音和温暖的模拟质感",
        "type": "one_shot",
        "key": "F#",
        "bpm": 2
    },
    "stem_control_tags": "add "
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    task: 'create',
    model: 'chirp-v50',
    make_instrumental: false,
    prompt: '[Verse]\nHello world, here I come...\n\n[Chorus]\nLa la la...',
    continued_aligned_prompt: '[Verse 1]\nOriginal lyrics...\n\n[Chorus]\nNew replaced lyrics...\n\n[Verse 2]\nMore lyrics...',
    infill_lyrics: '[Bridge]\nThis is the new bridge section\nWith updated lyrics...',
    gpt_description_prompt: 'A happy pop song about summer vacation',
    tags: 'Pop, Happy, Upbeat',
    negative_tags: 'Sad, Slow',
    title: 'Summer Vibes',
    clip_id: 'clip_abc123',
    continue_at: 30,
    range: {start_s: 15.36, end_s: 53.8},
    infill_type: 'smart',
    infill_context_range: {start_s: 0, end_s: 69.16},
    persona: {
      persona_id: 'persona_xyz789',
      artist_clip_id: 'clip_abc123',
      persona_style: 'vox'
    },
    controls: {style_weight: 0.6, audio_weight: 0.4, weirdness_constraint: 0.2, duration: 120},
    vocal_gender: 'm',
    audio_url: 'https://example.com/audio.mp3',
    mashup_clip_ids: ['clip_abc123', 'clip_def456'],
    playlist_id: '119573ff-8e48-4fe6-9029-39c76c9a5597',
    sound: {description: '深沉的低音和温暖的模拟质感', type: 'one_shot', key: 'F#', bpm: 2},
    stem_control_tags: 'add '
  })
};

fetch('https://api.mountsea.ai/suno/v2/generate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.mountsea.ai/suno/v2/generate",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'task' => 'create',
    'model' => 'chirp-v50',
    'make_instrumental' => false,
    'prompt' => '[Verse]
Hello world, here I come...

[Chorus]
La la la...',
    'continued_aligned_prompt' => '[Verse 1]
Original lyrics...

[Chorus]
New replaced lyrics...

[Verse 2]
More lyrics...',
    'infill_lyrics' => '[Bridge]
This is the new bridge section
With updated lyrics...',
    'gpt_description_prompt' => 'A happy pop song about summer vacation',
    'tags' => 'Pop, Happy, Upbeat',
    'negative_tags' => 'Sad, Slow',
    'title' => 'Summer Vibes',
    'clip_id' => 'clip_abc123',
    'continue_at' => 30,
    'range' => [
        'start_s' => 15.36,
        'end_s' => 53.8
    ],
    'infill_type' => 'smart',
    'infill_context_range' => [
        'start_s' => 0,
        'end_s' => 69.16
    ],
    'persona' => [
        'persona_id' => 'persona_xyz789',
        'artist_clip_id' => 'clip_abc123',
        'persona_style' => 'vox'
    ],
    'controls' => [
        'style_weight' => 0.6,
        'audio_weight' => 0.4,
        'weirdness_constraint' => 0.2,
        'duration' => 120
    ],
    'vocal_gender' => 'm',
    'audio_url' => 'https://example.com/audio.mp3',
    'mashup_clip_ids' => [
        'clip_abc123',
        'clip_def456'
    ],
    'playlist_id' => '119573ff-8e48-4fe6-9029-39c76c9a5597',
    'sound' => [
        'description' => '深沉的低音和温暖的模拟质感',
        'type' => 'one_shot',
        'key' => 'F#',
        'bpm' => 2
    ],
    'stem_control_tags' => 'add '
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.mountsea.ai/suno/v2/generate"

	payload := strings.NewReader("{\n  \"task\": \"create\",\n  \"model\": \"chirp-v50\",\n  \"make_instrumental\": false,\n  \"prompt\": \"[Verse]\\nHello world, here I come...\\n\\n[Chorus]\\nLa la la...\",\n  \"continued_aligned_prompt\": \"[Verse 1]\\nOriginal lyrics...\\n\\n[Chorus]\\nNew replaced lyrics...\\n\\n[Verse 2]\\nMore lyrics...\",\n  \"infill_lyrics\": \"[Bridge]\\nThis is the new bridge section\\nWith updated lyrics...\",\n  \"gpt_description_prompt\": \"A happy pop song about summer vacation\",\n  \"tags\": \"Pop, Happy, Upbeat\",\n  \"negative_tags\": \"Sad, Slow\",\n  \"title\": \"Summer Vibes\",\n  \"clip_id\": \"clip_abc123\",\n  \"continue_at\": 30,\n  \"range\": {\n    \"start_s\": 15.36,\n    \"end_s\": 53.8\n  },\n  \"infill_type\": \"smart\",\n  \"infill_context_range\": {\n    \"start_s\": 0,\n    \"end_s\": 69.16\n  },\n  \"persona\": {\n    \"persona_id\": \"persona_xyz789\",\n    \"artist_clip_id\": \"clip_abc123\",\n    \"persona_style\": \"vox\"\n  },\n  \"controls\": {\n    \"style_weight\": 0.6,\n    \"audio_weight\": 0.4,\n    \"weirdness_constraint\": 0.2,\n    \"duration\": 120\n  },\n  \"vocal_gender\": \"m\",\n  \"audio_url\": \"https://example.com/audio.mp3\",\n  \"mashup_clip_ids\": [\n    \"clip_abc123\",\n    \"clip_def456\"\n  ],\n  \"playlist_id\": \"119573ff-8e48-4fe6-9029-39c76c9a5597\",\n  \"sound\": {\n    \"description\": \"深沉的低音和温暖的模拟质感\",\n    \"type\": \"one_shot\",\n    \"key\": \"F#\",\n    \"bpm\": 2\n  },\n  \"stem_control_tags\": \"add \"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.mountsea.ai/suno/v2/generate")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"task\": \"create\",\n  \"model\": \"chirp-v50\",\n  \"make_instrumental\": false,\n  \"prompt\": \"[Verse]\\nHello world, here I come...\\n\\n[Chorus]\\nLa la la...\",\n  \"continued_aligned_prompt\": \"[Verse 1]\\nOriginal lyrics...\\n\\n[Chorus]\\nNew replaced lyrics...\\n\\n[Verse 2]\\nMore lyrics...\",\n  \"infill_lyrics\": \"[Bridge]\\nThis is the new bridge section\\nWith updated lyrics...\",\n  \"gpt_description_prompt\": \"A happy pop song about summer vacation\",\n  \"tags\": \"Pop, Happy, Upbeat\",\n  \"negative_tags\": \"Sad, Slow\",\n  \"title\": \"Summer Vibes\",\n  \"clip_id\": \"clip_abc123\",\n  \"continue_at\": 30,\n  \"range\": {\n    \"start_s\": 15.36,\n    \"end_s\": 53.8\n  },\n  \"infill_type\": \"smart\",\n  \"infill_context_range\": {\n    \"start_s\": 0,\n    \"end_s\": 69.16\n  },\n  \"persona\": {\n    \"persona_id\": \"persona_xyz789\",\n    \"artist_clip_id\": \"clip_abc123\",\n    \"persona_style\": \"vox\"\n  },\n  \"controls\": {\n    \"style_weight\": 0.6,\n    \"audio_weight\": 0.4,\n    \"weirdness_constraint\": 0.2,\n    \"duration\": 120\n  },\n  \"vocal_gender\": \"m\",\n  \"audio_url\": \"https://example.com/audio.mp3\",\n  \"mashup_clip_ids\": [\n    \"clip_abc123\",\n    \"clip_def456\"\n  ],\n  \"playlist_id\": \"119573ff-8e48-4fe6-9029-39c76c9a5597\",\n  \"sound\": {\n    \"description\": \"深沉的低音和温暖的模拟质感\",\n    \"type\": \"one_shot\",\n    \"key\": \"F#\",\n    \"bpm\": 2\n  },\n  \"stem_control_tags\": \"add \"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.mountsea.ai/suno/v2/generate")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"task\": \"create\",\n  \"model\": \"chirp-v50\",\n  \"make_instrumental\": false,\n  \"prompt\": \"[Verse]\\nHello world, here I come...\\n\\n[Chorus]\\nLa la la...\",\n  \"continued_aligned_prompt\": \"[Verse 1]\\nOriginal lyrics...\\n\\n[Chorus]\\nNew replaced lyrics...\\n\\n[Verse 2]\\nMore lyrics...\",\n  \"infill_lyrics\": \"[Bridge]\\nThis is the new bridge section\\nWith updated lyrics...\",\n  \"gpt_description_prompt\": \"A happy pop song about summer vacation\",\n  \"tags\": \"Pop, Happy, Upbeat\",\n  \"negative_tags\": \"Sad, Slow\",\n  \"title\": \"Summer Vibes\",\n  \"clip_id\": \"clip_abc123\",\n  \"continue_at\": 30,\n  \"range\": {\n    \"start_s\": 15.36,\n    \"end_s\": 53.8\n  },\n  \"infill_type\": \"smart\",\n  \"infill_context_range\": {\n    \"start_s\": 0,\n    \"end_s\": 69.16\n  },\n  \"persona\": {\n    \"persona_id\": \"persona_xyz789\",\n    \"artist_clip_id\": \"clip_abc123\",\n    \"persona_style\": \"vox\"\n  },\n  \"controls\": {\n    \"style_weight\": 0.6,\n    \"audio_weight\": 0.4,\n    \"weirdness_constraint\": 0.2,\n    \"duration\": 120\n  },\n  \"vocal_gender\": \"m\",\n  \"audio_url\": \"https://example.com/audio.mp3\",\n  \"mashup_clip_ids\": [\n    \"clip_abc123\",\n    \"clip_def456\"\n  ],\n  \"playlist_id\": \"119573ff-8e48-4fe6-9029-39c76c9a5597\",\n  \"sound\": {\n    \"description\": \"深沉的低音和温暖的模拟质感\",\n    \"type\": \"one_shot\",\n    \"key\": \"F#\",\n    \"bpm\": 2\n  },\n  \"stem_control_tags\": \"add \"\n}"

response = http.request(request)
puts response.read_body

{
  "taskId": "15c257ff-43f7-4678-bd41-202ad6b8488b"
}

The /generate endpoint supports 15 different task types, each requiring a different set of parameters. Before calling this endpoint, we strongly recommend using the Generate Schema endpoint to get the exact required/optional fields and a complete request example for your task type.

Quick Start

Check required parameters

Call GET /suno/v2/generate/schema?task=create to get the parameter schema and a request example for the create task.See Generate Schema →

Send generate request

Call POST /suno/v2/generate with the correct parameters for your task type.

Poll task status

Use the returned taskId to poll Get Task Status until status is success.

Task Types Overview

Task	Description	Key Required Fields
`create`	Create new music from scratch	`model`
`extend`	Extend existing music	`clip_id`, `model`
`upload_extend`	Extend uploaded audio	`audio_url`, `model`
`upload_cover`	Cover uploaded audio	`audio_url`, `model`
`cover`	Create cover of existing clip	`clip_id`, `model`
`use_styles_lyrics`	Use styles from clip with new lyrics	`clip_id`, `model`
`replace_section`	Replace a section of existing audio	`clip_id`, `range`, `infill_context_range`, `continued_aligned_prompt`, `model`
`add_instrumental`	Add instrumental to a range	`clip_id`, `range`, `model`
`add_vocals`	Add vocals to a range	`clip_id`, `range`, `model`
`gen_stem_two`	Generate two-track stems (vocals + instrumental)	`clip_id`, `model`
`gen_stem_all`	Generate all stems	`clip_id`, `model`
`mashup`	Mashup two songs	`mashup_clip_ids`, `model`
`sample`	Sample from existing clip	`clip_id`, `range`, `model`
`inspiration`	Generate from a real playlist	`playlist_id`, `model` — see Inspiration Guide
`sound`	Generate sound effects	`sound`, `model`

All tasks require the task and model fields. Use GET /suno/v2/generate/schema?task=xxx to get the full parameter details for any specific task type.

Common Parameters

These parameters are shared across most task types:

Parameter	Type	Description
`task`	string	Required. The task type (see table above)
`model`	string	Required. Model version: `chirp-v55`, `chirp-v50`, `chirp-45+`, `chirp-v45`, `chirp-v45-lite`, `chirp-v40`, `chirp-v35`
`prompt`	string	Lyrics or prompt text
`tags`	string \| string[]	Style tags (e.g., `"Pop, Happy, Upbeat"`)
`negative_tags`	string \| string[]	Styles to exclude
`title`	string	Song title
`make_instrumental`	boolean	Generate without vocals (default: `false`)
`vocal_gender`	string	`"m"` (male) or `"f"` (female)
`controls`	object	Advanced controls — see below
`persona`	object	Vocal persona for style mimicking

`controls` object

Field	Type	Description
`style_weight`	number	Style influence (0~1)
`audio_weight`	number	Original-audio influence (0~1)
`weirdness_constraint`	number	Creativity / weirdness (0~1); higher = more creative
`duration`	number	Target song length in seconds (10~360). Supported on chirp-v55+; older models and `chirp-custom:*` silently ignore it. Omit to let the model decide length

{
  "task": "create",
  "model": "chirp-v55",
  "prompt": "[Verse]\nHello world...",
  "tags": "Pop, Happy",
  "controls": {
    "style_weight": 0.6,
    "audio_weight": 0.4,
    "weirdness_constraint": 0.2,
    "duration": 120
  }
}

Examples

curl -X POST https://api.mountsea.ai/suno/v2/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key" \
  -d '{
    "task": "create",
    "model": "chirp-v55",
    "prompt": "[Verse]\nHello world, here I come...\n\n[Chorus]\nLa la la...",
    "tags": "Pop, Happy, Upbeat",
    "title": "Summer Vibes"
  }'

curl -X POST https://api.mountsea.ai/suno/v2/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key" \
  -d '{
    "task": "extend",
    "model": "chirp-v55",
    "clip_id": "clip_abc123",
    "continue_at": 30,
    "tags": "Pop, Happy"
  }'

curl -X POST https://api.mountsea.ai/suno/v2/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key" \
  -d '{
    "task": "sound",
    "model": "chirp-v55",
    "sound": {
      "description": "A deep bass drop with warm analog texture",
      "type": "one_shot",
      "key": "F#",
      "bpm": 120
    }
  }'

task=inspiration requires a real playlist_id from Create Playlist. The legacy pattern playlist_id: "inspiration" with playlist_clip_ids is deprecated. See the Inspiration workflow.

Not sure which parameters to pass? Call GET /suno/v2/generate/schema?task=your_task — it returns the required fields, optional fields, not-allowed fields, and a complete request example for each task type.Try Generate Schema →

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

task

enum<string>

required

Task type. Use GET /generate/schema?task=xxx to query required fields for each task.

Available options:

create,

extend,

upload_extend,

upload_cover,

cover,

use_styles_lyrics,

replace_section,

add_instrumental,

add_vocals,

gen_stem_two,

gen_stem_all,

mashup,

sample,

inspiration,

sound,

add_stems

Example:

"create"

model

string

required

Model version. Supports standard models (e.g. chirp-v50) and custom models (chirp-custom:).

Example:

"chirp-v50"

make_instrumental

boolean

default:false

Whether to make instrumental (no vocals). [Optional: all tasks]

Example:

false

prompt

string

Lyrics or prompt text. [Optional: all tasks] For replace_section: lyrics within infill_context_range (modified if replacement changes lyrics).

Example:

"[Verse]\nHello world, here I come...\n\n[Chorus]\nLa la la..."

continued_aligned_prompt

string

Full song lyrics after replacement. [Required: replace_section] Contains the complete lyrics of the entire song with the replaced section updated.

Example:

"[Verse 1]\nOriginal lyrics...\n\n[Chorus]\nNew replaced lyrics...\n\n[Verse 2]\nMore lyrics..."

infill_lyrics

string

Lyrics for the replaced section only. [Optional: replace_section] The specific lyrics within the range being replaced.

Example:

"[Bridge]\nThis is the new bridge section\nWith updated lyrics..."

gpt_description_prompt

string

Short description for GPT lyrics generation. [Optional: create, mashup, etc.]

Example:

"A happy pop song about summer vacation"

Response

201 - application/json

taskId

string

required

task id. Use this id to query task status.

Example:

"15c257ff-43f7-4678-bd41-202ad6b8488b"

Introduction Generate Schema

​Quick Start

​Task Types Overview

​Common Parameters

​controls object

​Examples

Authorizations

Body

Response

Quick Start

Task Types Overview

Common Parameters

`controls` object

Examples