generate_music
PRE-FETCH (mandatory before polling the result): resources/read kubeez://skills/polling — first-poll delays + cadence.
Scope: generate:music. Not generate:media — use generate_media for image/video, this tool only for music. Generate AI music. DEFAULT to SIMPLE mode for all prompt-based requests. Only switch to ADVANCED when the user explicitly provides or asks for lyrics, a specific song title, style tags, or vocal gender. SIMPLE MODE (default): set prompt only (max 400 chars); leave title, style, vocal_gender, song_description, and lyrics empty. Optional: instrumental, model. ADVANCED MODE (custom, use only when user asks for lyrics/title/style/vocal control): set BOTH title AND style (non-empty). Required: vocal_gender = m, f, or random (random = provider picks). Content: exactly ONE of song_description OR lyrics (never both). ADVANCED VOCAL songs need explicit lyrics — in custom mode the provider sings the text VERBATIM, so a song_description there gets auto-routed back to SIMPLE mode (style/title folded into the prompt; response carries mode_note). If you only have a description, use SIMPLE mode directly. Advanced instrumental: song_description only (omit lyrics). Optional: negative_tags, style_weight, weirdness_constraint, audio_weight (default 0.65). Invalid: title without style or style without title. MODEL: OMIT model so the server auto-picks the newest, best engine (currently V6). Only set it when the user explicitly names an engine. Valid: V6 (richest detail, most natural vocals), V6_WILD (bolder, more distinctive), V6_MINI (fast and light). Every version up to V5_5 is discontinued by the provider and is silently remapped to V6 at the same price. TREBLO: model='treblo-v3' is a second engine (full songs, vocal or instrumental, writes its own lyrics and picks its own length). It takes prompt (or song_description), optional lyrics, style, title, negative_tags and instrumental, with no simple/advanced split and no title+style pairing rule. vocal_gender m/f is optional and becomes its 'male vocalist'/'female vocalist' style tag; the three weights do not apply (ignored, reported in mode_note); persona_id and exact_duration_ms are refused. Style is split on commas into tags and the engine only takes tags from its own vocabulary: use short genre/era/vocal words ('pop, rap, 2010s'), not tempo, key or sentences ('100 BPM', 'A minor', 'catchy party hook'). Words it does not take are moved into the description or dropped, and named in mode_note; put tempo, key and mood phrasing in the prompt. REAL ARTIST NAMES are accepted as a style reference, in the prompt ('in the exact style of The Weeknd, Starboy era, ...') and as a style tag ('the weeknd, synthwave, pop, male vocalist'); the vocal is generated, not the artist's own voice. When a user asks for a song in the style of a named artist, use treblo-v3 and pass the name through: do not strip it or swap it for a genre description. Add 'No artist names in the lyrics.' to the prompt, or the lyrics can sing the name. Never paste a real song's lyrics. Poll get_status the same way. PERSONA: to reuse a saved persona, pass persona_id (from generate_music_persona or list_music_personas). It copies the singer's VOICE by default (persona_model='voice_persona', supported across the V6 family). Pass persona_model='style_persona' to copy the genre/vibe instead. Applying a persona forces custom mode automatically. LENGTH: Suno picks its own. For an instrumental bed at a length you choose, call generate_sound(model='sonilo-text-to-music', duration_seconds=...) instead — a length passed here is served there anyway, and cannot be combined with lyrics/vocal_gender/persona_id. Returns generation_id; poll get_status(id) until completed.
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": "generate_music"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | ||
| style | No | ||
| title | No | ||
| lyrics | No | ||
| prompt | No | ||
| persona_id | No | ||
| audio_weight | No | ||
| instrumental | No | ||
| style_weight | No | ||
| vocal_gender | No | ||
| negative_tags | No | ||
| output_format | No | RETIRED, do not set. The delivery format is not selectable on either music provider. Setting this changes nothing; the value is ignored and reported back in mode_note. | |
| persona_model | No | ||
| song_description | No | ||
| exact_duration_ms | No | Legacy spelling of a length request. Suno cannot honour one, so setting this runs sonilo-text-to-music at that length instead (INSTRUMENTAL, billed per second with a 10-second floor) and says so in mode_note. Rejected when combined with lyrics / vocal_gender / persona_id, which only Suno can do. Prefer generate_sound(model='sonilo-text-to-music', prompt=..., duration_seconds=<5-360>) directly. | |
| weirdness_constraint | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||