生成歌曲(集成)

POST /suno/submit/music

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

说明

接入步骤

A. 生成音乐

可以通过场生成歌曲接口生成后,获取其中的一首歌的 clip_id 值为: 54834687-5e79-4f08-8e14-cf188f15b598

B. 新建 Persona

  • clip_id 需要系统内存在的,非 uploader
  • 不能跨账号,所以可能账号下线用不了

C. 使用 persona_id 创作

注意事项:

  • mv 为 chirp-v3-5-tau 或者 chirp-v4-tau
  • task 为 artist_consistency
  • persona_id 为 B 步骤得到的
  • artist_clip_id 就是 A 步骤中的 clip_id
  • 可跨账号

概览

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

请求体

{
  "type": "application/json",
  "parameters": [],
  "jsonSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "$id": "https://your-api.com/schemas/suno-submit-music-request.json",
    "title": "SunoSubmitMusicRequest",
    "description": "POST /suno/submit/music 生成歌曲请求体(Open 渠道)。普通生成无需 task;Persona 创作须先 A 生成曲→B 创建 Persona→C 本接口。",
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "gpt_description_prompt": {
        "type": "string",
        "description": "灵感模式:用自然语言描述想要的音乐风格/主题(与 prompt 二选一,优先灵感)"
      },
      "prompt": {
        "type": "string",
        "description": "自定义模式:新歌歌词;续写/补段/重制/混搭等也常用。task=remaster 时上游必填"
      },
      "tags": {
        "type": "string",
        "description": "风格标签,逗号分隔,如 \"pop, piano, emotional\"。可空"
      },
      "title": {
        "type": "string",
        "description": "歌曲标题"
      },
      "mv": {
        "type": "string",
        "description": "模型版本;不传默认 chirp-v5。task=artist_consistency 时仅建议 chirp-v3-5-tau 或 chirp-v4-tau",
        "examples": [
          "chirp-v4-tau",
          "chirp-v3-5-tau",
          "chirp-v5",
          "chirp-v4",
          "chirp-v4-5",
          "chirp-v3-5"
        ]
      },
      "make_instrumental": {
        "type": "boolean",
        "default": false,
        "description": "是否生成纯音乐(无人声)"
      },
      "continue_clip_id": {
        "type": "string",
        "description": "续写/补段用的源 clip ID。须为已生成歌曲的 clip_id(从 GET /suno/fetch/:id 结果获取),非 task_id"
      },
      "continue_at": {
        "type": "number",
        "minimum": 0,
        "description": "从源音频第几秒开始续写(配合 continue_clip_id)"
      },
      "task_id": {
        "type": "string",
        "description": "关联原任务 ID,用于渠道路由(可选)"
      },
      "task": {
        "type": "string",
        "description": "特殊任务类型;不传则为普通生成(灵感/自定义/纯音乐)",
        "enum": [
          "extend",
          "upload_extend",
          "infill",
          "fixed_infill",
          "infill_intro",
          "infill_outro",
          "cover_infill",
          "cover_extend",
          "artist_infill",
          "artist_consistency",
          "cover",
          "image_to_song",
          "video_to_song",
          "concat",
          "sound",
          "underpainting",
          "remaster",
          "vox",
          "mashup_condition"
        ],
        "x-apifox-enum": [
          {
            "value": "extend",
            "name": "续写/延伸",
            "description": "从已有 clip 继续生成。需 continue_clip_id,可选 continue_at、prompt"
          },
          {
            "value": "upload_extend",
            "name": "上传后续写",
            "description": "基于上传音频的延伸(常与上传流程配合)"
          },
          {
            "value": "infill",
            "name": "局部编辑/补段",
            "description": "指定时间段重生成。需 continue_clip_id + metadata_params 时间段;换词用 metadata.infill_lyrics"
          },
          {
            "value": "fixed_infill",
            "name": "固定区间补段",
            "description": "与 infill 类似,固定区间编辑"
          },
          {
            "value": "infill_intro",
            "name": "片头补段",
            "description": "片头区间 infill"
          },
          {
            "value": "infill_outro",
            "name": "片尾补段",
            "description": "片尾区间 infill"
          },
          {
            "value": "cover_infill",
            "name": "Cover 局部编辑",
            "description": "Cover 场景局部补段"
          },
          {
            "value": "cover_extend",
            "name": "Cover 延伸",
            "description": "Cover 场景延伸生成"
          },
          {
            "value": "artist_infill",
            "name": "歌手风格局部编辑",
            "description": "Persona 场景下的局部补段"
          },
          {
            "value": "artist_consistency",
            "name": "歌手风格一致",
            "description": "须先:A submit/music 得 clip_id → B submit/persona 得 persona_id → 本接口。必填 persona_id、artist_clip_id(=A 的 clip_id)、prompt;mv 仅 chirp-v3-5-tau 或 chirp-v4-tau。Persona 创建不可跨账号;创作可跨账号(以渠道为准)"
          },
          {
            "value": "cover",
            "name": "Cover 翻唱",
            "description": "翻唱/改编一首。需 metadata_params.clip_id + 建议 prompt、tags"
          },
          {
            "value": "image_to_song",
            "name": "图生曲",
            "description": "图片参考生成音乐,按上游要求传 metadata_params"
          },
          {
            "value": "video_to_song",
            "name": "视频生曲",
            "description": "视频参考生成音乐"
          },
          {
            "value": "concat",
            "name": "拼接",
            "description": "多段拼接;也可走 POST /suno/submit/concat"
          },
          {
            "value": "sound",
            "name": "音效生成",
            "description": "短音效。需 metadata_params.sound、type(如 loop)。以渠道实测为准"
          },
          {
            "value": "underpainting",
            "name": "添加伴奏",
            "description": "在已有 clip 上铺伴奏。需 metadata_params.underpainting_clip_id 及起止秒"
          },
          {
            "value": "remaster",
            "name": "重制/变奏",
            "description": "重制已有曲。必填 prompt + metadata_params.clip_id;可选 variation_category(如 normal)"
          },
          {
            "value": "vox",
            "name": "哼唱成曲",
            "description": "哼唱/人声参考生成。需 artist_clip_id。以渠道实测为准"
          },
          {
            "value": "mashup_condition",
            "name": "双曲混搭",
            "description": "两首参考曲混搭成一首新歌(非混响)。必填 metadata_params.mashup_clip_ids(通常 2 个 clip_id)+ prompt"
          }
        ]
      },
      "metadata": {
        "type": "object",
        "description": "扩展字段;可通过 metadata.task 或 metadata.metadata_params 传参(与顶层二选一即可)",
        "additionalProperties": true,
        "properties": {
          "task": {
            "type": "string"
          },
          "metadata_params": {
            "$ref": "#/$defs/metadataParams"
          },
          "metadataParams": {
            "$ref": "#/$defs/metadataParams"
          }
        },
        "x-apifox-orders": [
          "task",
          "metadata_params",
          "metadataParams"
        ]
      },
      "metadata_params": {
        "$ref": "#/$defs/metadataParams"
      },
      "persona_id": {
        "type": "string",
        "format": "uuid",
        "description": "Persona ID。仅 task=artist_consistency 时必填。须先 POST /suno/submit/persona 创建成功后从 fetch 结果获取;无固定枚举,不可手写假 UUID。Persona 与创建账号绑定,不可跨账号复用创建步骤。"
      },
      "artist_clip_id": {
        "type": "string",
        "format": "uuid",
        "description": "源曲 clip_id(步骤 A 生成音乐后从 fetch 结果取得)。task=artist_consistency 时必填,且应与创建 Persona 时使用的 root_clip_id 为同一首源曲。须为系统内已生成 clip,非 uploader 临时 ID。"
      }
    },
    "$defs": {
      "metadataParams": {
        "type": "object",
        "description": "Open 渠道扩展参数,按 task 传不同子字段;未列出的键可能透传上游",
        "additionalProperties": true,
        "properties": {
          "persona_id": {
            "type": "string",
            "description": "Persona ID(可与顶层 persona_id 二选一,顶层会合并注入)"
          },
          "artist_clip_id": {
            "type": "string",
            "description": "源曲 clip_id(可与顶层 artist_clip_id 二选一)"
          },
          "mashup_clip_ids": {
            "type": "array",
            "description": "task=mashup_condition:参与混搭的参考曲 clip_id 列表,通常 2 个",
            "minItems": 2,
            "items": {
              "type": "string",
              "format": "uuid"
            }
          },
          "continue_clip_id": {
            "type": "string",
            "description": "infill:源 clip;未传时可能从顶层 continue_clip_id 自动注入"
          },
          "continued_aligned_prompt": {
            "type": "string",
            "description": "infill:对齐提示;未传时可能从顶层 prompt 自动注入"
          },
          "infill_start_s": {
            "type": "number",
            "minimum": 0,
            "description": "infill:替换片段起始秒"
          },
          "infill_end_s": {
            "type": "number",
            "minimum": 0,
            "description": "infill:替换片段结束秒"
          },
          "infill_context_start_s": {
            "type": "number",
            "minimum": 0,
            "description": "infill:上下文起始秒"
          },
          "infill_context_end_s": {
            "type": "number",
            "minimum": 0,
            "description": "infill:上下文结束秒"
          },
          "metadata": {
            "type": "object",
            "description": "infill 嵌套元数据",
            "additionalProperties": true,
            "properties": {
              "infill_lyrics": {
                "type": "string",
                "description": "局部替换后的新歌词"
              }
            },
            "x-apifox-orders": [
              "infill_lyrics"
            ]
          },
          "underpainting_clip_id": {
            "type": "string",
            "description": "underpainting:源 clip ID"
          },
          "underpainting_start_s": {
            "type": "number",
            "minimum": 0,
            "description": "underpainting:区间起始秒"
          },
          "underpainting_end_s": {
            "type": "number",
            "minimum": 0,
            "description": "underpainting:区间结束秒"
          },
          "clip_id": {
            "type": "string",
            "description": "remaster / cover 等:单首源 clip ID"
          },
          "variation_category": {
            "type": "string",
            "description": "remaster:变化类别",
            "examples": [
              "normal"
            ]
          },
          "sound": {
            "type": "string",
            "description": "sound:音效描述,如 bird sound"
          },
          "type": {
            "type": "string",
            "description": "sound:音效类型,如 loop",
            "examples": [
              "loop"
            ]
          }
        },
        "x-apifox-orders": [
          "persona_id",
          "artist_clip_id",
          "mashup_clip_ids",
          "continue_clip_id",
          "continued_aligned_prompt",
          "infill_start_s",
          "infill_end_s",
          "infill_context_start_s",
          "infill_context_end_s",
          "metadata",
          "underpainting_clip_id",
          "underpainting_start_s",
          "underpainting_end_s",
          "clip_id",
          "variation_category",
          "sound",
          "type"
        ]
      }
    },
    "examples": [
      {
        "gpt_description_prompt": "一首轻快的爵士钢琴曲",
        "mv": "chirp-v4-tau",
        "title": "灵感模式示例"
      },
      {
        "prompt": "verse: 夜风轻轻吹...\nchorus: 星光照大地...",
        "tags": "pop, piano, emotional",
        "title": "星光下的承诺",
        "mv": "chirp-v4"
      },
      {
        "tags": "jazz, smooth",
        "mv": "chirp-v4",
        "make_instrumental": true,
        "title": "纯音乐示例"
      },
      {
        "task": "extend",
        "continue_clip_id": "54834687-5e79-4f08-8e14-cf188f15b598",
        "continue_at": 30,
        "prompt": "继续后半段,情绪更激昂",
        "mv": "chirp-v4-tau"
      },
      {
        "task": "artist_consistency",
        "persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
        "artist_clip_id": "54834687-5e79-4f08-8e14-cf188f15b598",
        "prompt": "[Verse 1]\n新歌歌词...",
        "tags": "pop",
        "title": "Persona 创作示例",
        "make_instrumental": false,
        "mv": "chirp-v4-tau"
      },
      {
        "task": "remaster",
        "prompt": "保持原曲气质,做适度变化",
        "mv": "chirp-v5",
        "metadata_params": {
          "clip_id": "54834687-5e79-4f08-8e14-cf188f15b598",
          "variation_category": "normal"
        }
      },
      {
        "task": "mashup_condition",
        "prompt": "[Verse 1]\n混搭新歌歌词...",
        "title": "歌曲A x 歌曲B (Mashup)",
        "tags": "",
        "make_instrumental": false,
        "mv": "chirp-v5",
        "metadata_params": {
          "mashup_clip_ids": [
            "498c3c1b-c538-4857-866e-31b35d752efd",
            "5469b97c-3bab-49d7-8d05-bc13d6df48b3"
          ]
        }
      },
      {
        "task": "infill",
        "mv": "chirp-v4-5",
        "prompt": "[Verse]\n旧歌词上下文",
        "continue_clip_id": "54834687-5e79-4f08-8e14-cf188f15b598",
        "metadata_params": {
          "infill_start_s": 28.48,
          "infill_end_s": 53.16,
          "infill_context_start_s": 1.44,
          "infill_context_end_s": 80.2,
          "metadata": {
            "infill_lyrics": "[Verse]\n这里是替换后的新歌词"
          }
        }
      }
    ],
    "x-apifox-orders": [
      "gpt_description_prompt",
      "prompt",
      "tags",
      "title",
      "mv",
      "make_instrumental",
      "continue_clip_id",
      "continue_at",
      "task_id",
      "task",
      "persona_id",
      "artist_clip_id",
      "metadata_params",
      "metadata"
    ]
  },
  "required": true,
  "mediaType": "",
  "examples": [
    {
      "name": "新手推荐:灵感模式 · gpt_description_prompt",
      "value": "{\r\n    \"gpt_description_prompt\": \"一首轻快的爵士钢琴曲,适合咖啡厅背景\",\r\n    \"mv\": \"chirp-v4\"\r\n}",
      "mediaType": "application/json"
    },
    {
      "name": "新手推荐:自定义模式 · prompt+tags+title",
      "value": "{\r\n    \"prompt\": \"verse: 夜风轻轻吹\\nchorus: 星光照大地\",\r\n    \"tags\": \"pop, piano, emotional\",\r\n    \"title\": \"星光下的承诺\",\r\n    \"mv\": \"chirp-v4\"\r\n}",
      "mediaType": "application/json"
    },
    {
      "name": "新手推荐:纯音乐 · make_instrumental+tags",
      "value": "{\r\n    \"tags\": \"ambient, electronic, calm\",\r\n    \"mv\": \"chirp-v4\",\r\n    \"make_instrumental\": true\r\n}",
      "mediaType": "application/json"
    },
    {
      "name": "新手推荐:纯音乐 · make_instrumental+tags+title",
      "value": "{\r\n    \"tags\": \"classical, piano\",\r\n    \"title\": \"晨光序曲\",\r\n    \"mv\": \"chirp-v4\",\r\n    \"make_instrumental\": true\r\n}",
      "mediaType": "application/json"
    },
    {
      "name": "新手推荐:灵感模式 · mv=默认(不传)",
      "value": "{\r\n    \"gpt_description_prompt\": \"测试默认模型版本\"\r\n}",
      "mediaType": "application/json"
    },
    {
      "name": "新手推荐:音效 · task=sound+metadata_params",
      "value": "{\r\n    \"task\": \"sound\",\r\n    \"mv\": \"chirp-v5\",\r\n    \"metadata_params\": {\r\n        \"sound\": \"bird sound\",\r\n        \"type\": \"loop\"\r\n    }\r\n}",
      "mediaType": "application/json"
    },
    {
      "name": "进阶推荐:续写 · continue_clip_id+continue_at+prompt",
      "value": "{\r\n    \"continue_clip_id\": \"{{clip_id}}\",\r\n    \"continue_at\": 30.5,\r\n    \"prompt\": \"这段要更加激昂,加入鼓点\",\r\n    \"mv\": \"chirp-v4\"\r\n}",
      "mediaType": "application/json"
    },
    {
      "name": "进阶推荐:续写 · continue_clip_id+task_id",
      "value": "{\r\n    \"continue_clip_id\": \"{{clip_id}}\",\r\n    \"continue_at\": 20,\r\n    \"task_id\": \"{{task_id}}\",\r\n    \"prompt\": \"续写后半段\",\r\n    \"mv\": \"chirp-v4\"\r\n}",
      "mediaType": "application/json"
    },
    {
      "name": "进阶推荐:启发创作 · gpt_description_prompt+artist_clip_id",
      "value": "{\r\n    \"gpt_description_prompt\": \"参考这段音频的氛围,创作一首新的流行歌曲\",\r\n    \"artist_clip_id\": \"{{clip_id}}\",\r\n    \"tags\": \"pop, emotional\",\r\n    \"mv\": \"chirp-v5\"\r\n}",
      "mediaType": "application/json"
    },
    {
      "name": "进阶推荐:歌手风格 · task=artist_consistency+persona_id+artist_clip_id",
      "value": "{\r\n    \"task\": \"artist_consistency\",\r\n    \"persona_id\": \"{{persona_id}}\",\r\n    \"artist_clip_id\": \"{{clip_id}}\",\r\n    \"prompt\": \"[Verse]\\n测试歌词\",\r\n    \"tags\": \"pop\",\r\n    \"title\": \"歌手风格测试\",\r\n    \"mv\": \"chirp-v5\"\r\n}",
      "mediaType": "application/json"
    },
    {
      "name": "进阶推荐:Cover翻版 · task=cover+clip_id+prompt",
      "value": "{\r\n    \"task\": \"cover\",\r\n    \"prompt\": \"将这首歌翻唱成女声流行风格\",\r\n    \"tags\": \"pop, female vocal\",\r\n    \"mv\": \"chirp-v5\",\r\n    \"metadata_params\": {\r\n        \"clip_id\": \"{{clip_id}}\"\r\n    }\r\n}",
      "mediaType": "application/json"
    },
    {
      "name": "进阶推荐:重制 · task=remaster+clip_id+variation_category",
      "value": "{\r\n    \"task\": \"remaster\",\r\n    \"prompt\": \"保持原曲风格,做适度变化\",\r\n    \"tags\": \"pop\",\r\n    \"title\": \"重制测试\",\r\n    \"mv\": \"chirp-v5\",\r\n    \"metadata_params\": {\r\n        \"clip_id\": \"{{clip_id}}\",\r\n        \"variation_category\": \"normal\"\r\n    }\r\n}",
      "mediaType": "application/json"
    },
    {
      "name": "进阶推荐:局部编辑 · task=infill+continue_clip_id+时间段",
      "value": "{\r\n    \"task\": \"infill\",\r\n    \"mv\": \"chirp-v4-5\",\r\n    \"prompt\": \"[Verse]\\n旧歌词上下文\",\r\n    \"continue_clip_id\": \"{{clip_id}}\",\r\n    \"metadata_params\": {\r\n        \"infill_start_s\": 28.48,\r\n        \"infill_end_s\": 53.16,\r\n        \"infill_context_start_s\": 1.44,\r\n        \"infill_context_end_s\": 80.2\r\n    }\r\n}",
      "mediaType": "application/json"
    },
    {
      "name": "进阶推荐:局部替换歌词 · task=infill+infill_lyrics",
      "value": "{\r\n    \"task\": \"infill\",\r\n    \"continue_clip_id\": \"{{clip_id}}\",\r\n    \"prompt\": \"[Verse]\\n旧歌词上下文\",\r\n    \"mv\": \"chirp-v4-5\",\r\n    \"metadata_params\": {\r\n        \"infill_start_s\": 28.48,\r\n        \"infill_end_s\": 53.16,\r\n        \"infill_context_start_s\": 1.44,\r\n        \"infill_context_end_s\": 80.2,\r\n        \"metadata\": {\r\n            \"infill_lyrics\": \"[Verse]\\n这里是替换后的新歌词\"\r\n        }\r\n    }\r\n}",
      "mediaType": "application/json"
    },
    {
      "name": "进阶推荐:添加伴奏 · task=underpainting+metadata_params",
      "value": "{\r\n    \"task\": \"underpainting\",\r\n    \"title\": \"添加伴奏测试\",\r\n    \"tags\": \"ambient\",\r\n    \"mv\": \"chirp-v5\",\r\n    \"metadata_params\": {\r\n        \"underpainting_clip_id\": \"{{clip_id}}\",\r\n        \"underpainting_start_s\": 0,\r\n        \"underpainting_end_s\": 30\r\n    }\r\n}",
      "mediaType": "application/json"
    },
    {
      "name": "进阶推荐:添加人声 · task=underpainting+prompt+metadata_params",
      "value": "{\r\n    \"task\": \"underpainting\",\r\n    \"prompt\": \"加入温柔女声主歌\",\r\n    \"tags\": \"pop, female vocal\",\r\n    \"title\": \"添加人声测试\",\r\n    \"make_instrumental\": false,\r\n    \"mv\": \"chirp-v5\",\r\n    \"metadata_params\": {\r\n        \"underpainting_clip_id\": \"{{clip_id}}\",\r\n        \"underpainting_start_s\": 0,\r\n        \"underpainting_end_s\": 30\r\n    }\r\n}",
      "mediaType": "application/json"
    },
    {
      "name": "进阶推荐:哼唱成曲 · task=vox+artist_clip_id+prompt",
      "value": "{\r\n    \"task\": \"vox\",\r\n    \"artist_clip_id\": \"{{clip_id}}\",\r\n    \"prompt\": \"根据哼唱旋律生成完整流行歌曲\",\r\n    \"tags\": \"pop, piano\",\r\n    \"title\": \"哼唱成曲测试\",\r\n    \"mv\": \"chirp-v5\"\r\n}",
      "mediaType": "application/json"
    },
    {
      "name": "进阶推荐:双曲混搭 · task=mashup_condition+mashup_clip_ids×2+prompt",
      "value": "{\r\n  \"mv\": \"chirp-v5\",\r\n  \"make_instrumental\": false,\r\n  \"prompt\": \"[Verse 1]\\n太阳爬上小窗台\\n...\",\r\n  \"tags\": \"\",\r\n  \"title\": \"歌曲A x 歌曲B (Mashup)\",\r\n  \"task\": \"mashup_condition\",\r\n  \"metadata_params\": {\r\n    \"mashup_clip_ids\": [\r\n      \"498c3c1b-c538-4857-866e-31b35d752efd\",\r\n      \"5469b97c-3bab-49d7-8d05-bc13d6df48b3\"\r\n    ]\r\n  }\r\n}",
      "mediaType": "application/json"
    },
    {
      "name": "进阶推荐:图生曲(灵感 + 图片 URL)· task+gpt_description_prompt+metadata_params(image_url)",
      "value": "{\r\n    \"task\": \"image_to_song\",\r\n    \"gpt_description_prompt\": \"根据这张图片的氛围写一首温暖轻快的流行歌,女声,节奏适中,适合午后阳光的感觉\",\r\n    \"tags\": \"pop, warm, uplifting, female vocal, acoustic\",\r\n    \"title\": \"图生曲测试\",\r\n    \"mv\": \"chirp-v4\",\r\n    \"make_instrumental\": false,\r\n    \"metadata_params\": {\r\n        \"image_url\": \"https://img95.699pic.com/photo/30340/0037.jpg_wh860.jpg\"\r\n    }\r\n}",
      "mediaType": "application/json"
    },
    {
      "name": "进阶推荐:上传后续写 · task=upload_extend+continue_clip_id",
      "value": "{\r\n    \"task\": \"upload_extend\",\r\n    \"prompt\": \"在已上传音频基础上继续延伸,情绪更饱满\",\r\n    \"tags\": \"pop, emotional\",\r\n    \"title\": \"上传后续写测试\",\r\n    \"mv\": \"chirp-v4\",\r\n    \"make_instrumental\": false,\r\n    \"continue_clip_id\": \"{{clip_id}}\",\r\n    \"continue_at\": 15,\r\n    \"metadata_params\": {\r\n        \"clip_id\": \"{{clip_id}}\"\r\n    }\r\n}",
      "mediaType": "application/json"
    },
    {
      "name": "进阶推荐:固定补段 · task=fixed_infill+时间段",
      "value": "{\r\n    \"task\": \"fixed_infill\",\r\n    \"mv\": \"chirp-v4-5\",\r\n    \"prompt\": \"[Verse]\\n保留前后文歌词上下文\",\r\n    \"tags\": \"pop\",\r\n    \"title\": \"固定区间补段\",\r\n    \"continue_clip_id\": \"{{clip_id}}\",\r\n    \"metadata_params\": {\r\n        \"continue_clip_id\": \"{{clip_id}}\",\r\n        \"continued_aligned_prompt\": \"[Verse]\\n保留前后文歌词上下文\",\r\n        \"infill_start_s\": 20,\r\n        \"infill_end_s\": 40,\r\n        \"infill_context_start_s\": 0,\r\n        \"infill_context_end_s\": 90\r\n    }\r\n}",
      "mediaType": "application/json"
    },
    {
      "name": "进阶推荐:片头补段 · infill_intro",
      "value": "{\r\n  \"task\": \"infill_intro\",\r\n  \"mv\": \"chirp-v4-5\",\r\n  \"prompt\": \"[Intro]\\n新的开场段落\",\r\n  \"title\": \"片头补段测试\",\r\n  \"continue_clip_id\": \"{{clip_id}}\",\r\n  \"metadata_params\": {\r\n    \"infill_start_s\": 0,\r\n    \"infill_end_s\": 12,\r\n    \"infill_context_start_s\": 0,\r\n    \"infill_context_end_s\": 60,\r\n    \"metadata\": {\r\n      \"infill_lyrics\": \"[Intro]\\n全新开场歌词\"\r\n    }\r\n  }\r\n}",
      "mediaType": "application/json"
    },
    {
      "name": "进阶推荐:片尾补段 · infill_outro",
      "value": "{\r\n    \"task\": \"infill_outro\",\r\n    \"mv\": \"chirp-v4-5\",\r\n    \"prompt\": \"[Outro]\\n收尾渐弱\",\r\n    \"title\": \"片尾补段测试\",\r\n    \"continue_clip_id\": \"{{clip_id}}\",\r\n    \"metadata_params\": {\r\n        \"infill_start_s\": 75,\r\n        \"infill_end_s\": 95,\r\n        \"infill_context_start_s\": 50,\r\n        \"infill_context_end_s\": 120\r\n    }\r\n}",
      "mediaType": "application/json"
    },
    {
      "name": "进阶推荐:Cover局部 · task=cover_infill+clip_id",
      "value": "{\r\n    \"task\": \"cover_infill\",\r\n    \"mv\": \"chirp-v4-5\",\r\n    \"prompt\": \"[Verse]\\nCover 风格下的局部重唱\",\r\n    \"tags\": \"rock, cover\",\r\n    \"title\": \"Cover 局部编辑\",\r\n    \"continue_clip_id\": \"{{clip_id}}\",\r\n    \"metadata_params\": {\r\n        \"clip_id\": \"{{clip_id}}\",\r\n        \"infill_start_s\": 30,\r\n        \"infill_end_s\": 55,\r\n        \"infill_context_start_s\": 5,\r\n        \"infill_context_end_s\": 85\r\n    }\r\n}",
      "mediaType": "application/json"
    },
    {
      "name": "进阶推荐:Cover延伸 · task=cover_extend+continue_at",
      "value": "{\r\n    \"task\": \"cover_extend\",\r\n    \"prompt\": \"延续 Cover 段落,加强吉他与鼓点\",\r\n    \"tags\": \"rock, energetic\",\r\n    \"title\": \"Cover 延伸\",\r\n    \"mv\": \"chirp-v4\",\r\n    \"continue_clip_id\": \"{{clip_id}}\",\r\n    \"continue_at\": 45,\r\n    \"metadata_params\": {\r\n        \"clip_id\": \"{{clip_id}}\"\r\n    }\r\n}",
      "mediaType": "application/json"
    },
    {
      "name": "进阶推荐:Persona补段 · task=artist_infill+persona_id",
      "value": "{\r\n    \"task\": \"artist_infill\",\r\n    \"persona_id\": \"{{persona_id}}\",\r\n    \"artist_clip_id\": \"{{clip_id}}\",\r\n    \"mv\": \"chirp-v4-tau\",\r\n    \"prompt\": \"[Verse]\\n保持歌手音色,只改这一段\",\r\n    \"title\": \"Persona 局部补段\",\r\n    \"continue_clip_id\": \"{{clip_id}}\",\r\n    \"metadata_params\": {\r\n        \"persona_id\": \"{{persona_id}}\",\r\n        \"artist_clip_id\": \"{{clip_id}}\",\r\n        \"infill_start_s\": 25,\r\n        \"infill_end_s\": 48,\r\n        \"infill_context_start_s\": 0,\r\n        \"infill_context_end_s\": 80\r\n    }\r\n}",
      "mediaType": "application/json"
    },
    {
      "name": "进阶推荐:视频生曲 · task=video_to_song+video_url",
      "value": "{\r\n  \"task\": \"video_to_song\",\r\n  \"gpt_description_prompt\": \"根据视频画面节奏写一首电子氛围曲,偏电影感\",\r\n  \"tags\": \"electronic, cinematic, ambient\",\r\n  \"title\": \"视频生曲测试\",\r\n  \"mv\": \"chirp-v4\",\r\n  \"make_instrumental\": false,\r\n  \"metadata_params\": {\r\n    \"video_url\": \"https://你的域名/path/to/reference.mp4\"\r\n  }\r\n}",
      "mediaType": "application/json"
    }
  ],
  "oasExtensions": ""
}

响应

[
  {
    "id": 113908130,
    "name": "成功",
    "code": 200,
    "contentType": "json",
    "jsonSchema": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "data": {
          "type": "string"
        }
      },
      "required": [
        "code",
        "message",
        "data"
      ],
      "x-apifox-orders": [
        "code",
        "message",
        "data"
      ]
    },
    "itemSchema": {},
    "description": "",
    "mediaType": "",
    "headers": []
  }
]

响应示例

[
  {
    "name": "示例 1",
    "responseId": 113908130,
    "data": "{\r\n    \"code\": \"success\",\r\n    \"message\": \"\",\r\n    \"data\": \"1268154180129529857\"\r\n}",
    "id": "019e8246-6a2f-74ad-904d-480aa141fc28"
  }
]