> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mountsea.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 混搭

> task=mashup — 正好两段混成一首

`mashup_clip_ids` 必须是**正好两首**。一首、或者三首及以上都会被拒绝。不传 `gpt_description_prompt` 时，服务端会补上 `A creative mashup song`。

`POST /suno/v2/generate` 返回 `{ "taskId" }`。轮询 [查询任务状态](/zh/api-reference/suno/task)。Schema：`GET /suno/v2/generate/schema?task=mashup`。

## 参数

| 字段 | 必填 | 说明 |
| - | - | - |
| `task` | 是 | `"mashup"` |
| `model` | 是 | 建议 `chirp-v6` |
| `mashup_clip_ids` | 是 | 正好两个片段 id |
| `gpt_description_prompt` | 否 | 混搭听起来应该怎样。不传则服务端补 `A creative mashup song` |
| `title` / `tags` | 否 | 结果歌名和风格 |

其他可选字段：[共用列表](/zh/api-reference/suno/generate-tasks#shared-optional-fields)。

## 示例

```json theme={null}
{
  "task": "mashup",
  "model": "chirp-v6",
  "title": "Two Songs",
  "gpt_description_prompt": "Blend the groove of the first with the melody of the second",
  "mashup_clip_ids": [
    "b6aa42d8-8ee6-40de-8953-8be4fc5d3406",
    "3e7e9538-c474-45a7-8181-3da327bd654b"
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.