Skip to main content
Replace a span when you do not want to build 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 title and tags to keep the original song’s title and style.
  • infill_type is deprecated. smart, classic, and fixed all become infill.

Lyrics, in order

The server picks the first rule that applies:
  1. continued_aligned_prompt — you already wrote the full lyrics with the new lines in place.
  2. Otherwise the original lyrics, swapping original_infill_lyrics for infill_lyrics (a one-line change).
  3. Otherwise the original lyrics unchanged (music-only; the words stay).
  4. Otherwise HTTP 400 — the clip has no lyrics and you did not send continued_aligned_prompt.

Parameters

Examples

Music only. The original words stay:
Swap one line:
You already have the full lyric sheet: