var2_create_audio
Create, COVER, EXTEND, or edit MUSIC / a song / a track (Suno). type ∈ create-music (default) | cover-music | extend-music | replace-music-section. "Cover this song in a " / "redo my track as jazz" / "same melody, new style / new lyrics" → type=cover-music with the song in audio_url (an https URL — upload a local file with var2_upload_asset first) OR audioRecordId (a var2 track); style = the new style; lyrics optional (empty keeps the original words); instrumental=true drops vocals. Source ≤ 8 minutes; returns 2 takes. Copyrighted recordings are NOT allowed as the source: Suno fingerprints it and rejects commercial songs ("matches an existing recording"). Only the user's own or royalty-free songs, e.g. a var2 track. "extend that track by N seconds" / "make the song longer" / "continue past 1:00" → type=extend-music, track id in audioRecordId. "That track" without a re-pasted id = the track from earlier in this conversation — use its placeholder_id from context; never answer null / ask for a link. "replace / swap seconds X-Y of the track" → type=replace-music-section. ANY make/extend/lengthen/replace-section on a song / track / music = THIS tool — never a video or image tool, never an invented tool. "A song AND cover art" → START HERE (art = follow-up var2_create_image, not an upload). customMode=false: prompt = song description ≤2800 chars on V6/V6_WILD (≤500 on V5_5 and older). customMode=true: prompt = full lyrics; style + title required. Never name real artists or songs (copyright filter).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "var2_create_audio"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Default create-music. cover-music = re-style an existing song (audio_url or audioRecordId), keeping its melody. | |
| model | No | Default suno. | |
| style | No | Required when customMode=true. Max 200 chars. | |
| title | No | Required when customMode=true. | |
| lyrics | No | cover-music only: new lyrics for the same melody. Omit to keep the original words. | |
| prompt | No | customMode=false: song description ≤2800 chars on V6/V6_WILD, ≤500 on older (Suno writes lyrics). customMode=true: full lyrics. | |
| audio_url | No | cover-music only: https URL of the song to cover (≤ 8 min). Any public URL, a var2 storage URL, or the url from var2_upload_asset / var2_request_upload for a local file. | |
| continueAt | No | Required for extend-music. Seconds offset to extend from. | |
| customMode | No | Default false. Set true when the user provides exact lyrics. Requires style + title. | |
| infillEndS | No | Required for replace-music-section. Window end in seconds (> infillStartS; ~6-60s window). | |
| webhook_url | No | Optional. https:// URL var2 POSTs a signed delivery to when the asset is ready (or fails). Signature header: X-VAR2-Signature: t=<unix>, v1=<hex(hmac_sha256(webhook_secret, t + "." + body))>. Retried with exponential backoff (8 attempts over ~4 days). | |
| audio_weight | No | cover-music only: closeness to the source sound (0–1). Omit to let Suno decide. | |
| infillStartS | No | Required for replace-music-section. Window start in seconds. | |
| instrumental | No | ||
| vocal_gender | No | cover-music only: preferred vocal gender. | |
| audioRecordId | No | Required for extend-music / replace-music-section; one of audio_url / audioRecordId for cover-music. placeholder_id from the source var2_create_audio call (var2-hosted tracks only). "That track" = the most recent track in this conversation — take its placeholder_id from context rather than declining. | |
| model_version | No | Default V6 (latest). V6_WILD for bolder, more experimental takes. Older only for a specific sound. | V6 |