suno-music
Suno V5.5 music generation. Inspiration mode (auto lyrics) or custom mode (manual style/title/lyrics). Generates music with or without vocals, with fine-grained controls over style weight, weirdness and audio weight.
Suno V5.5 music generation. Inspiration mode (auto lyrics) or custom mode (manual style/title/lyrics). Generates music with or without vocals, with fine-grained controls over style weight, weirdness and audio weight.
Overview
| Field | Value |
|---|---|
| Model ID | suno-music |
| CLI | dlazy suno-music |
| MCP | suno-music (Claude Code surfaces this as mcp__dlazy__suno-music) |
| Type | audio |
| Execution | Async task; the CLI polls until completion (--no-wait returns generateId immediately) |
| Batch | Supports --batch <n> parallel fan-out |
Parameters
| Arg | Type | Required | Notes |
|---|---|---|---|
customMode | string | No | Custom Mode; default false |
instrumental | string | No | Instrumental (No Vocals); default false |
prompt | string | No | Prompt; default "" |
style | string | No | Style; default ""; only when customMode=true |
title | string | No | Title; default ""; only when customMode=true |
negativeTags | string | No | Negative Tags (styles to exclude); default "" |
vocalGender | "m" | "f" | No | Vocal Gender（m=Male; f=Female）; default "f"; only when instrumental=false |
styleWeight | string | No | Style Weight (0-1); default 0.65 |
weirdnessConstraint | string | No | Weirdness (0-1); default 0.65 |
audioWeight | string | No | Audio Weight (0-1); default 0.65 |
--input @file.jsonor--input '{...}'can supply all args at once; flags take precedence over--inputkeys.
CLI Examples
dlazy suno-music --help
dlazy suno-music --customMode false --instrumental false --prompt ""
dlazy suno-music --customMode false --instrumental false --prompt "" --dry-run
dlazy suno-music --customMode false --instrumental false --prompt "" --no-wait
dlazy suno-music --customMode false --instrumental false --prompt "" --batch 4MCP
MCP is consumed by AI clients, not handwritten. Once dLazy is registered as an MCP server the tool appears in the client's tool list — Claude Code surfaces it as mcp__dlazy__suno-music; generic clients (e.g. OpenClaw) call it as suno-music.
See MCP setup for how to add the server.
Output
{
"outputs": [
{ "type": "audio", "id": "o_...", "url": "https://files.dlazy.com/result.mp3", "mimeType": "audio/mpeg" }
]
}Media tools emit image / video / audio / file outputs. Use --output url to print only the URLs on stdout.