Dlazy Suno.Music

Automatically create complete songs with vocals and accompaniment based on lyrics or style descriptions using Suno AI.

Security Scan

The skill is an instruction-only wrapper that calls the dLazy CLI/service to generate music; its requirements and instructions are consistent with that purpose.

Purpose & Capability

Name/description, required binaries (npm/npx), and all referenced endpoints (api.dlazy.com, oss.dlazy.com) align with a CLI client for the dLazy music service. The metadata points to the @dlazy/cli npm package and GitHub repo, which is coherent for this functionality.

Instruction Scope

SKILL.md instructs the agent to run the dLazy CLI and describes uploading of local media to dLazy's OSS and use of their API. It does not ask the agent to read unrelated system files or exfiltrate data to unexpected endpoints. The agent is told to notify users on credential/credit errors, which is prescriptive but within scope.

Install Mechanism

No install spec is bundled with the registry entry (instruction-only), but the instructions reference installing via npm or npx from the official @dlazy/cli package and the GitHub repo. These are standard, traceable install sources (npm/GitHub) and not high-risk download URLs.

Credentials

The skill does not declare required environment variables, though it documents optional DLAZY_API_KEY usage and a user config file (~/.dlazy/config.json) — appropriate for a CLI that requires an API key. No unrelated credentials or broad secrets are requested.

Persistence & Privilege

always:false and normal model invocation are used. The skill expects to store its own API key in a per-user config path (~/.dlazy/config.json), which is proportional to its stated purpose and does not request system-wide or other-skills' credentials.

Assessment

This skill is a thin client for the dLazy music service and appears internally consistent. Before installing or running it: (1) review the @dlazy/cli GitHub repo and the pinned npm version (1.0.6) for authenticity; (2) prefer npx for one-off runs instead of a global install if you don't trust installing a global package; (3) do not pass private or sensitive audio/text files you wouldn't want uploaded to a cloud service, since media files are uploaded to oss.dlazy.com; (4) ensure your dLazy API key scope and organization settings are appropriate and rotate/revoke keys if needed; (5) if you require higher assurance, verify the npm package integrity (checksums/signatures) and repository maintainer details.

English · 中文

Automatically create complete songs with vocals and accompaniment based on lyrics or style descriptions using Suno AI.

Trigger Keywords

• suno music
• generate song
• ai music
• write a song

Authentication

All requests require a dLazy API key, configured through the CLI:

dlazy auth set YOUR_API_KEY

The CLI saves the key in your user config directory (~/.dlazy/config.json on macOS/Linux, %USERPROFILE%\.dlazy\config.json on Windows), with file permissions restricted to your OS user account. You can also supply the key per-invocation via the DLAZY_API_KEY environment variable.

Getting Your API Key

1. Sign in or create an account at dlazy.com
2. Go to dlazy.com/dashboard/organization/api-key
3. Copy the key shown in the API Key section

Each key is scoped to your dLazy organization and can be rotated or revoked at any time from the same dashboard.

About & Provenance

• CLI source code: github.com/dlazyai/cli
• Maintainer: dlazyai
• npm package: @dlazy/cli (pinned to 1.0.6 in this skill's install spec)
• Homepage: dlazy.com

You can install on demand without persisting a global binary by running:

npx @dlazy/cli@1.0.6 <command>

Or, if you prefer a global install, the skill's metadata.clawdbot.install field declares the exact pinned version (npm install -g @dlazy/cli@1.0.6). Review the GitHub source before installing.

How It Works

This skill is a thin client over the dLazy hosted API. When you invoke it:

• Prompts and parameters you provide are sent to the dLazy API endpoint (api.dlazy.com) for inference.
• Any local file paths you pass to image / video / audio fields are uploaded to dLazy's media storage (oss.dlazy.com) so the model can read them — the same flow as any cloud-based generation API.
• Generated output URLs returned by the API are hosted on oss.dlazy.com.

This is the standard SaaS pattern; the skill itself does not access network or filesystem resources beyond what the dLazy CLI already handles. See dlazy.com for the full service terms.

Usage

CRITICAL INSTRUCTION FOR AGENT: Run the dlazy suno.music command to get results.

dlazy suno.music -h

Options:
  --mode <mode>                        Mode [default: inspiration] (choices: "inspiration", "custom")
  --prompt <prompt>                    Prompt [default: ]
  --title <title>                      Title [default: ] [only when mode="custom"]
  --tags <tags...>                     Tags (max 20) [default: ] [only when mode="custom"]
  --make_instrumental <make_instrumental>Instrumental (No Vocals) [default: false] [only when mode="inspiration"]
  --input <spec>                       JSON payload: inline string, @file, or - (stdin)
  --dry-run                            Print payload + cost estimate without calling API
  --no-wait                            Return generateId immediately for async tasks
  --timeout <seconds>                  Max seconds to wait for async completion (default: "1800")
  -h, --help                           display help for command

Output Format

{
  "ok": true,
  "kind": "urls",
  "data": {
    "urls": [
      "https://oss.dlazy.com/result.mp4"
    ]
  }
}

Command Examples

# basic call:
dlazy suno.music --prompt 'prompt text'

# complex call:
dlazy suno.music --prompt 'prompt text'

Error Handling

Code	Error Type	Example Message
401	Unauthorized (No API Key)	ok: false, code: "unauthorized", message: "API key is missing or invalid"
501	Missing required parameter	error: required option '--prompt <prompt>' not specified
502	Local file read error	Error: Image file/Video file not found: C:\path\to\your\file
503	API request failed (no balance)	ok: false, code: "insufficient_balance"
503	API request failed (server error)	HTTP status code error (500 server crash)
504	Asynchronous task execution failed	=== Generation Failed === / {Specific error reason returned by backend, for example "Prompt violates safety policy"}

AGENT CRITICAL INSTRUCTION:

1. If the execution result returns code: "insufficient_balance", you MUST explicitly inform the user that their credits are insufficient and guide them to recharge: https://dlazy.com/dashboard/organization/settings?tab=credits
2. If the execution result returns code: "unauthorized" or indicates missing API key, you MUST inform the user to get their API key from https://dlazy.com/dashboard/organization/api-key and save it using dlazy auth set <key> and resume the task.

Tips

Visit https://dlazy.com for more information.