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

# 剪辑与改造

> crop/removeSection/fadeIn/fadeOut/adjustSpeed/replaceMusic/sample/mashup/concat/coverSong/remaster

<Note>
  **国内用户请注意：** 中国大陆用户请使用 `https://toapis.cn` 作为接口地址（Base URL）。
</Note>

剪辑与改造类操作，全部以已有任务为源：

```
POST https://toapis.com/v1/music/generations/{operation}
```

<ParamField body="model" type="string" required>固定 `"suno"`</ParamField>
<ParamField body="task_id" type="string" required>源任务 ID（本平台 `tsk_aud_` ID)</ParamField>
<ParamField body="audio_index" type="number">源曲目序号</ParamField>

## 时间段剪辑(\$0.008 / 次）

| operation | 说明 | 额外必填 |
| - | - | - |
| `crop` | 截取时间段保留 | `start_s`、`end_s` |
| `removeSection` | 删除时间段 | `start_s`、`end_s` |

```bash theme={null}
curl --request POST \
  --url https://toapis.com/v1/music/generations/crop \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"model":"suno","task_id":"tsk_aud_xxx","audio_index":1,"start_s":10,"end_s":40}'
```

## 淡入淡出(\$0.008 / 次）

| operation | 说明 | 额外必填 |
| - | - | - |
| `fadeIn` | 开头淡入 | `duration_s` |
| `fadeOut` | 结尾淡出 | `duration_s` |

## adjustSpeed — 变速(\$0.024)

<ParamField body="speed" type="number" required>速度倍率，如 `0.8` / `1.25`</ParamField>
<ParamField body="keep_pitch" type="boolean">变速时保持音调</ParamField>

## 换写与重制

### replaceMusic — 片段换写($0.05,Max $0.10)

<ParamField body="start_s" type="number" required>换写起点（秒）</ParamField>
<ParamField body="end_s" type="number" required>换写终点（秒）</ParamField>
<ParamField body="infill_lyrics" type="string">该片段的新歌词</ParamField>
<ParamField body="max_mode" type="boolean">Max 档（本操作无 `custom`，直接生效）</ParamField>

### sample — 采样重编排($0.05,Max $0.10)

<Warning>`task_id` 必须是 `uploadTask` 产物，其他源会被拒绝。</Warning>

<ParamField body="start_s" type="number" required>采样起点（秒）</ParamField>
<ParamField body="end_s" type="number" required>采样终点（秒）</ParamField>
<ParamField body="gpt_description" type="string">重编排描述（custom=false 时必填）</ParamField>

### coverSong — 翻唱($0.05,Max $0.10)

<ParamField body="gpt_description" type="string">目标风格描述（custom=false 时必填）</ParamField>

<ParamField body="custom" type="boolean" />

<ParamField body="prompt" type="string">custom=true 时的歌词</ParamField>
<ParamField body="style" type="string">目标风格</ParamField>

### remaster — 音质重制(\$0.05)

<ParamField body="variation_category" type="string">重制取向（可选）</ParamField>

### mashup — 混编($0.05,Max $0.10)

<ParamField body="task_ids" type="array" required>恰好 2 个源任务 ID</ParamField>
<ParamField body="audio_indexes" type="array">各源任务的曲目序号</ParamField>
<ParamField body="gpt_description" type="string">混编风格描述（custom=false 时必填）</ParamField>

```bash theme={null}
curl --request POST \
  --url https://toapis.com/v1/music/generations/mashup \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"model":"suno","task_ids":["tsk_aud_aaa","tsk_aud_bbb"],"gpt_description":"blend into seamless lo-fi"}'
```

### concat — 拼接(\$0.004)

拼接 `extend` 产生的分段为完整曲目。

<ParamField body="task_id" type="string" required>`extend` 源任务 ID</ParamField>

## Response

<ResponseField name="task_id" type="string">新任务 ID</ResponseField>
<ResponseField name="status" type="string">`submitted`</ResponseField>


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