> ## 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.

# 混搭歌词

> 将两首歌曲的歌词组合生成混搭歌词

将两首歌曲的歌词组合生成混搭歌词。纯乐器曲目请使用 `[Instrumental]`。生成混搭歌词后，使用 [Generate](/zh/api-reference/suno/generate) 端点配合 `task=mashup` 来创建音乐。

## 请求体

<ParamField body="lyrics_a" type="string" required>
  第一首歌曲的歌词。如果是纯乐器曲目，请使用 `[Instrumental]`。
</ParamField>

<ParamField body="lyrics_b" type="string" required>
  第二首歌曲的歌词。如果是纯乐器曲目，请使用 `[Instrumental]`。
</ParamField>

## 响应

<ResponseField name="taskId" type="string">
  任务 ID。使用此 ID 通过[获取任务状态](/zh/api-reference/suno/task)查询任务状态。
</ResponseField>

## 示例

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.mountsea.ai/suno/v2/mashupLyrics \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer your-api-key" \
    -d '{
      "lyrics_a": "[Verse 1]\nWalking down the street today\nSunshine lighting up my way\n\n[Chorus]\nFeeling so alive, feeling so free",
      "lyrics_b": "[Instrumental]"
    }'
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://api.mountsea.ai/suno/v2/mashupLyrics', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer your-api-key'
    },
    body: JSON.stringify({
      lyrics_a: '[Verse 1]\nWalking down the street today\nSunshine lighting up my way\n\n[Chorus]\nFeeling so alive, feeling so free',
      lyrics_b: '[Instrumental]'
    })
  });

  const data = await response.json();
  console.log(data.taskId);
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      'https://api.mountsea.ai/suno/v2/mashupLyrics',
      headers={
          'Content-Type': 'application/json',
          'Authorization': 'Bearer your-api-key'
      },
      json={
          'lyrics_a': '[Verse 1]\nWalking down the street today\nSunshine lighting up my way\n\n[Chorus]\nFeeling so alive, feeling so free',
          'lyrics_b': '[Instrumental]'
      }
  )

  data = response.json()
  print(data['taskId'])
  ```
</CodeGroup>

## 响应示例

```json theme={null}
{
  "taskId": "15c257ff-43f7-4678-bd41-202ad6b8488b"
}
```

## 工作流程

<Steps>
  <Step title="生成混搭歌词">
    使用两首歌曲的歌词调用此端点，生成组合后的混搭歌词。
  </Step>

  <Step title="检查任务状态">
    使用返回的 `taskId` 轮询[任务状态](/zh/api-reference/suno/task)端点，获取生成的混搭歌词。
  </Step>

  <Step title="生成混搭音乐">
    将混搭歌词与 [Generate](/zh/api-reference/suno/generate) 端点配合使用（`task=mashup`），创建最终的混搭曲目。
  </Step>
</Steps>

<Tip>
  当其中一个曲目没有人声时，请使用 `[Instrumental]` 作为歌词值。这在创建有声曲目与纯乐器曲目之间的混搭时非常有用。
</Tip>