Skip to main content
GET
/
suno
/
v2
/
generate
/
schema
Generate Schema
curl --request GET \
  --url https://api.mountsea.ai/suno/v2/generate/schema
{
  "task": "<string>",
  "description": "<string>",
  "required": [
    {}
  ],
  "optional": [
    {}
  ],
  "notAllowed": [
    {}
  ],
  "example": {}
}
This endpoint helps you understand what parameters are required or optional for each task type when using the Generate endpoint.
Recommended Workflow: Before calling /generate, first call this endpoint with your desired task type to understand exactly which fields to include in your request.

​
Query Parameters

​
task
string
The task type to get schema for. If not provided, returns schemas for all tasks.
ValueDescription
createCreate new music from scratch
extendExtend existing music
upload_extendExtend uploaded audio
upload_coverCover uploaded audio
coverCreate cover of existing clip
use_styles_lyricsUse styles from existing clip with new lyrics
replace_sectionReplace a section of existing audio
add_instrumentalAdd instrumental to audio
add_vocalsAdd vocals to audio
gen_stem_twoGenerate two-track stems
gen_stem_allGenerate all stems
mashupMashup two songs
sampleSample from existing clip
inspirationGenerate from inspiration playlist
soundGenerate sound effects

​
Response

Returns an array of task schema objects containing:
​
task
string
The task type identifier.
​
description
string
Human-readable description of the task.
​
required
array
List of required fields with their descriptions, types, and examples.
​
optional
array
List of optional fields with their descriptions, types, and examples.
​
notAllowed
array
List of fields that will be ignored for this task type.
​
example
object
A complete request example for this specific task.

​
Example

curl -X GET "https://api.mountsea.ai/suno/v2/generate/schema" \
  -H "Authorization: Bearer your-api-key"

​
Response Example

[
  {
    "task": "extend",
    "description": "Extend existing music",
    "required": [
      {
        "field": "clip_id",
        "description": "Source clip ID",
        "example": "clip_abc123",
        "type": "string"
      }
    ],
    "optional": [
      {
        "field": "continue_at",
        "description": "Continue position in seconds",
        "example": 30,
        "type": "number"
      },
      {
        "field": "tags",
        "description": "Style tags",
        "example": "Pop, Happy",
        "type": "string"
      },
      {
        "field": "prompt",
        "description": "Lyrics or prompt text",
        "example": "[Verse]\nHello world...",
        "type": "string"
      }
    ],
    "notAllowed": [
      "range",
      "audio_url"
    ],
    "example": {
      "task": "extend",
      "model": "chirp-v55",
      "clip_id": "clip_abc123",
      "continue_at": 30,
      "tags": "Pop, Happy"
    }
  }
]

​
Task Types Overview

TaskDescriptionKey Required Fields
createCreate new musicmodel
extendExtend existing clipclip_id, model
upload_extendExtend uploaded audioaudio_url, model
upload_coverCover uploaded audioaudio_url, model
coverCover existing clipclip_id, model
use_styles_lyricsUse styles with new lyricsclip_id, model
replace_sectionReplace audio sectionclip_id, range, infill_context_range, continued_aligned_prompt, model
add_instrumentalAdd instrumentalclip_id, range, model
add_vocalsAdd vocalsclip_id, range, model
gen_stem_twoTwo-track stemsclip_id, model
gen_stem_allAll stemsclip_id, model
mashupMashup two songsmashup_clip_ids, model
sampleSample from existing clipclip_id, range, model
inspirationGenerate from real playlistplaylist_id, model — see Inspiration Guide
soundGenerate sound effectssound, model
All tasks require task and model fields. Use this endpoint to get the complete list of required and optional fields for each specific task type.