生成歌曲(哼唱成曲)

POST /suno/submit/music

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

概览

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

请求体

{
  "type": "application/json",
  "parameters": [],
  "jsonSchema": {
    "type": "object",
    "properties": {
      "mv": {
        "description": "建议 v5 及以上(chirp-v5 / chirp-v5-5)",
        "type": "string"
      },
      "make_instrumental": {
        "description": "false=有人声成曲,true=纯音乐成曲",
        "type": "boolean"
      },
      "prompt": {
        "description": "必填,完整歌词,最多 3000 字",
        "type": "string"
      },
      "tags": {
        "description": "风格,建议填写,最多 200 字",
        "type": "string"
      },
      "title": {
        "description": "标题,可空",
        "type": "string"
      },
      "task": {
        "description": "必填,固定值",
        "type": "string"
      },
      "metadata_params": {
        "type": "object",
        "properties": {
          "chop_sample_clip_id": {
            "description": "必填,参考 clipId;也支持 mp3 公网 URL",
            "type": "string"
          },
          "chop_sample_start_s": {
            "description": "必填,参考片段起始秒",
            "type": "integer"
          },
          "chop_sample_end_s": {
            "description": "必填,参考片段结束秒;须 ≤ 原音频时长",
            "type": "integer"
          }
        },
        "required": [
          "chop_sample_clip_id",
          "chop_sample_start_s",
          "chop_sample_end_s"
        ],
        "x-apifox-orders": [
          "chop_sample_clip_id",
          "chop_sample_start_s",
          "chop_sample_end_s"
        ]
      }
    },
    "required": [
      "mv",
      "make_instrumental",
      "prompt",
      "tags",
      "task",
      "metadata_params"
    ],
    "x-apifox-orders": [
      "mv",
      "make_instrumental",
      "prompt",
      "tags",
      "title",
      "task",
      "metadata_params"
    ]
  },
  "required": true,
  "mediaType": "",
  "examples": [
    {
      "mediaType": "application/json",
      "value": "{\n  \"mv\": \"chirp-v5\",                                      // 建议 v5 及以上(chirp-v5 / chirp-v5-5)\n  \"make_instrumental\": false,                            // false=有人声成曲,true=纯音乐成曲\n  \"prompt\": \"[Verse 1]\\n太阳爬上小窗台\\n...\",            // 必填,完整歌词,最多 3000 字\n  \"tags\": \"pop,female voice\",                            // 风格,建议填写,最多 200 字\n  \"title\": \"哼唱成曲测试\",                                // 标题,可空\n  \"task\": \"chop_sample_condition\",                       // 必填,固定值\n  \"metadata_params\": {\n    \"chop_sample_clip_id\": \"4b2300c2-f200-4011-8f80-e3401da28c4f\",  // 必填,参考 clipId;也支持 mp3 公网 URL\n    \"chop_sample_start_s\": 0,                            // 必填,参考片段起始秒\n    \"chop_sample_end_s\": 30                              // 必填,参考片段结束秒;须 ≤ 原音频时长\n  }\n}"
    }
  ],
  "oasExtensions": ""
}

响应

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