Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
task=replace_section — rewrite a span with explicit context
replace_section.
Use a span of at least 4 seconds. Shorter selections usually fail and the credits are refunded. This task does not widen the span for you — Simple replace does.
infill_context_range should reach about 30 seconds before range.start_s and 30 seconds after range.end_s.
POST /suno/v2/generate returns { "taskId" }. Poll Get Task Status. Schema: GET /suno/v2/generate/schema?task=replace_section.
| Field | Required | Notes |
|---|---|---|
task | Yes | "replace_section" |
model | Yes | chirp-v6 recommended |
clip_id | Yes | Clip to edit |
range | Yes | { "start_s", "end_s" }. Prefer ≥ 4s. Shorter spans usually fail and are refunded |
infill_context_range | Yes | About 30s before range.start_s and 30s after range.end_s |
continued_aligned_prompt | Yes | Full lyrics with the replacement already written in |
prompt | No | Lyrics that fall inside infill_context_range |
infill_lyrics | No | The replacement lines alone |
infill_type | No | Deprecated. smart / classic / fixed all infill |
persona | No | Allowed |
{
"task": "replace_section",
"model": "chirp-v6",
"title": "Summer Vibes (Fixed)",
"tags": "Pop, Happy",
"clip_id": "056436f6-86b6-4cbb-a7f7-dc7bc202ea66",
"range": { "start_s": 15.36, "end_s": 53.8 },
"infill_context_range": { "start_s": 0, "end_s": 69.16 },
"continued_aligned_prompt": "[Verse]\nSunshine on my face today\n[Chorus]\nSummer vibes, feeling free",
"infill_lyrics": "Summer vibes, feeling free"
}