infill_context_range or the full aligned lyrics yourself. The server snaps the range, widens it if needed, and stores, bills, and reports the task as replace_section.
POST /suno/v2/generate returns { "taskId" }. Poll Get Task Status. Schema: GET /suno/v2/generate/schema?task=replace_simple.
What the server does
- Range snaps to a 40ms grid.
- A span shorter than 4 seconds is widened around its center. The result is still capped at 120 seconds.
- A song shorter than 4 seconds is HTTP 400.
- Context is about ±15 seconds around the span. Do not send
infill_context_range— it is ignored and not allowed. - Omit
titleandtagsto keep the original song’s title and style. infill_typeis deprecated.smart,classic, andfixedall become infill.
Lyrics, in order
The server picks the first rule that applies:continued_aligned_prompt— you already wrote the full lyrics with the new lines in place.- Otherwise the original lyrics, swapping
original_infill_lyricsforinfill_lyrics(a one-line change). - Otherwise the original lyrics unchanged (music-only; the words stay).
- Otherwise HTTP 400 — the clip has no lyrics and you did not send
continued_aligned_prompt.