prompt is the lyric.
POST /suno/v2/generate returns { "taskId" }. Poll Get Task Status. Schema: GET /suno/v2/generate/schema?task=add_vocals.
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=add_vocals — sing over an instrumental clip
prompt is the lyric.
POST /suno/v2/generate returns { "taskId" }. Poll Get Task Status. Schema: GET /suno/v2/generate/schema?task=add_vocals.
| Field | Required | Notes |
|---|---|---|
task | Yes | "add_vocals" |
model | Yes | chirp-v6 recommended |
clip_id | Yes | Instrumental clip |
prompt | No | Lyrics to sing |
tags | No | Vocal style |
{
"task": "add_vocals",
"model": "chirp-v6",
"title": "With Vocals",
"tags": "Pop, Male Vocal",
"clip_id": "e5f4e6d0-0ce1-432a-b2f0-c42860cdd98d",
"prompt": "[Verse]\nWalking down the street tonight\n[Chorus]\nThis is where I belong"
}