> ## 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=replace_simple — 只给片段和时间；按 replace_section 存储

只知道要改哪一段、不想自己拼 `infill_context_range` 和完整对齐歌词时用这个。服务端对齐时间、必要时加宽，存储、计费和状态都显示为 **`replace_section`**。

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

## 服务端会做什么

* 时间对齐到 40ms 网格。
* 短于 4 秒的区间会以中点为中心加宽。结果最长 **120 秒**。
* 整首歌短于 4 秒 → **HTTP 400**。
* 上下文大约是这段前后 **±15 秒**。不要传 `infill_context_range`，会被忽略，也不允许。
* 不传 `title` 和 `tags` 就保留原曲歌名和风格。
* `infill_type` 已废弃。`smart`、`classic`、`fixed` 都变成 infill。

## 歌词，按这个顺序

服务端用第一条能用上的规则：

1. `continued_aligned_prompt` — 你已经写好带新词的完整歌词。
2. 否则用原歌词，把 `original_infill_lyrics` 换成 `infill_lyrics`（改一句）。
3. 否则原歌词不动（只改音乐，词不变）。
4. 否则 **HTTP 400** — 片段没有歌词，你也没传 `continued_aligned_prompt`。

## 参数

| 字段 | 必填 | 说明 |
| - | - | - |
| `task` | 是 | `"replace_simple"` |
| `model` | 是 | 建议 `chirp-v6` |
| `clip_id` | 是 | 要改的片段 |
| `range` | 是 | `{ "start_s", "end_s" }` |
| `continued_aligned_prompt` | 否 | 完整歌词。优先于其他歌词字段 |
| `original_infill_lyrics` | 否 | 要在原歌词里找到的原句 |
| `infill_lyrics` | 否 | 替换成的新句 |
| `title` / `tags` | 否 | 不传则保留原曲 |
| `persona` | 否 | 可选的 artist infill |

## 示例

只改音乐，原词保留：

```json theme={null}
{
  "task": "replace_simple",
  "model": "chirp-v6",
  "clip_id": "3e7e9538-c474-45a7-8181-3da327bd654b",
  "range": { "start_s": 30, "end_s": 45 }
}
```

换一句：

```json theme={null}
{
  "task": "replace_simple",
  "model": "chirp-v6",
  "clip_id": "3e7e9538-c474-45a7-8181-3da327bd654b",
  "range": { "start_s": 30, "end_s": 45 },
  "original_infill_lyrics": "old line here",
  "infill_lyrics": "new line here"
}
```

已经有完整歌词：

```json theme={null}
{
  "task": "replace_simple",
  "model": "chirp-v6",
  "clip_id": "3e7e9538-c474-45a7-8181-3da327bd654b",
  "range": { "start_s": 30, "end_s": 45 },
  "continued_aligned_prompt": "[Verse]\nSunshine on my face today\n[Chorus]\nBrand new chorus line"
}
```


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