生成歌曲(添加伴奏)

POST /suno/submit/music

MethodPOST
Path/suno/submit/music
Typehttp
Status-2
Module2102810
Folder86482047

概览

MethodPOST
Path/suno/submit/music
Typehttp
Status-2
Module2102810
Folder86482047

请求体

{
  "type": "application/json",
  "parameters": [],
  "jsonSchema": {
    "type": "object",
    "properties": {
      "mv": {
        "description": "模型版本,不传默认 chirp-v5",
        "type": "string"
      },
      "prompt": {
        "description": "固定为空字符串,不传歌词",
        "type": "string"
      },
      "tags": {
        "description": "伴奏风格,建议填写,最多 200 字",
        "type": "string"
      },
      "title": {
        "description": "标题,可空",
        "type": "string"
      },
      "task": {
        "description": "必填,固定值",
        "type": "string"
      },
      "metadata_params": {
        "type": "object",
        "properties": {
          "underpainting_clip_id": {
            "description": "必填,人声/清唱 clipId;也支持 mp3 公网 URL",
            "type": "string"
          },
          "underpainting_start_s": {
            "description": "必填,处理起始秒数",
            "type": "integer"
          },
          "underpainting_end_s": {
            "description": "必填,处理结束秒数;须 ≤ 原音频时长",
            "type": "integer"
          }
        },
        "required": [
          "underpainting_clip_id",
          "underpainting_start_s",
          "underpainting_end_s"
        ],
        "x-apifox-orders": [
          "underpainting_clip_id",
          "underpainting_start_s",
          "underpainting_end_s"
        ]
      }
    },
    "required": [
      "mv",
      "prompt",
      "tags",
      "title",
      "task",
      "metadata_params"
    ],
    "x-apifox-orders": [
      "mv",
      "prompt",
      "tags",
      "title",
      "task",
      "metadata_params"
    ]
  },
  "required": true,
  "mediaType": "",
  "examples": [
    {
      "mediaType": "application/json",
      "value": "{\n  \"mv\": \"chirp-v5\",                                      // 模型版本,不传默认 chirp-v5\n  \"prompt\": \"\",                                          // 固定为空字符串,不传歌词\n  \"tags\": \"ambient\",                                     // 伴奏风格,建议填写,最多 200 字\n  \"title\": \"添加伴奏\",                                    // 标题,可空\n  \"task\": \"underpainting\",                               // 必填,固定值\n  \"metadata_params\": {\n    \"underpainting_clip_id\": \"xxx-clip-id\",              // 必填,人声/清唱 clipId;也支持 mp3 公网 URL\n    \"underpainting_start_s\": 0,                          // 必填,处理起始秒数\n    \"underpainting_end_s\": 30                            // 必填,处理结束秒数;须 ≤ 原音频时长\n  }\n}"
    }
  ],
  "oasExtensions": ""
}

响应

[
  {
    "id": 175956099,
    "name": "成功",
    "code": 200,
    "contentType": "json",
    "jsonSchema": {
      "type": "object",
      "properties": {}
    },
    "itemSchema": {},
    "description": "",
    "mediaType": "",
    "headers": []
  }
]