clip_id and write a new song from it. prompt is the new lyric.
POST /suno/v2/generate returns { "taskId" }. Poll Get Task Status. Schema: GET /suno/v2/generate/schema?task=sample.
Parameters
Other optional fields: shared list.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
task=sample — new song from a time range of a clip
clip_id and write a new song from it. prompt is the new lyric.
POST /suno/v2/generate returns { "taskId" }. Poll Get Task Status. Schema: GET /suno/v2/generate/schema?task=sample.
| Field | Required | Notes |
|---|---|---|
task | Yes | "sample" |
model | Yes | chirp-v6 recommended |
clip_id | Yes | Clip to sample |
range | Yes | { "start_s", "end_s" } inside the clip |
prompt | No | Lyrics for the new song |
tags / negative_tags | No | Style, or styles to exclude |
{
"task": "sample",
"model": "chirp-v6",
"title": "Leftover Umbrella",
"tags": "eccentric",
"prompt": "[Verse 1]\nFound you in the hallway...\n\n[Chorus]\nLeftover umbrella...",
"clip_id": "57d1a8e9-4b31-47d5-be06-e984ac136d1e",
"range": { "start_s": 66.08, "end_s": 233.52 },
"make_instrumental": false
}