跳转到主要内容
GET
/
suno
/
v2
/
generate
/
schema
生成参数模式
curl --request GET \
  --url https://api.mountsea.ai/suno/v2/generate/schema
{
  "task": "<string>",
  "description": "<string>",
  "required": [
    {}
  ],
  "optional": [
    {}
  ],
  "notAllowed": [
    {}
  ],
  "example": {}
}
此端点帮助您了解在使用 Generate 端点时，每种任务类型需要哪些必填或可选参数。
推荐工作流程：在调用 /generate 之前，先使用您所需的任务类型调用此端点，以准确了解请求中应包含哪些字段。

​
查询参数

​
task
string
要获取模式的任务类型。如果不提供，则返回所有任务的模式。
值描述
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生成音效

​
响应

返回一个任务模式对象数组，包含以下内容：
​
task
string
任务类型标识符。
​
description
string
任务的可读描述。
​
required
array
必填字段列表，包含其描述、类型和示例。
​
optional
array
可选字段列表，包含其描述、类型和示例。
​
notAllowed
array
该任务类型会忽略的字段列表。
​
example
object
针对此特定任务的完整请求示例。

​
示例

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

​
响应示例

[
  {
    "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"
    }
  }
]

​
任务类型概览

任务描述关键必填字段
create创建新音乐model
extend延伸已有片段clip_id, model
upload_extend延伸已上传的音频audio_url, model
upload_cover翻唱已上传的音频audio_url, model
cover翻唱已有片段clip_id, model
use_styles_lyrics使用风格搭配新歌词clip_id, model
replace_section替换音频段落clip_id, range, infill_context_range, continued_aligned_prompt, model
add_instrumental添加伴奏clip_id, range, model
add_vocals添加人声clip_id, range, model
gen_stem_two双轨音轨分离clip_id, model
gen_stem_all全部音轨分离clip_id, model
mashup混搭两首歌曲mashup_clip_ids, model
sample从已有片段中采样clip_id, range, model
inspiration从播放列表生成playlist_clip_ids, model
sound生成音效sound, model
所有任务都需要 task 和 model 字段。使用此端点获取每种特定任务类型的完整必填和可选字段列表。