按意图把图像、视频、音频请求分发到合适的 dlazy CLI 模型。
设计与多媒体
音频生成 Audio Generate
按提示词自动选用合适的 dlazy CLI 音频模型,完成语音、音乐、音效与声音克隆。
它能做什么
基于 dLazy 云端 API 的轻量客户端,会根据请求内容挑选最合适的 `dlazy` 音频模型并执行推理。可用模型覆盖 ElevenLabs、Suno、Gemini、Doubao、Kling、Qwen、Vidu 等供应商,支持多语种 TTS、原创音乐、短音效以及自定义声音克隆。需要通过 `dlazy login` 或 `dlazy auth set` 配置 dLazy API Key,推理在 `api.dlazy.com` 完成,生成结果以托管链接形式返回。
什么时候用它
- 为视频或解说生成多语言配音
- 用自然语言描述生成 10–300 秒的背景音乐
- 为短片、游戏或 UI 提示生成 1–22 秒的音效
- 上传干净音色样本,克隆可复用的自定义语音
技能文档
音频生成 Audio Generate
English · 中文
Audio generation skill. Automatically selects the best dlazy CLI audio/TTS model based on the prompt. 音频生成技能。根据提示词自动选择最佳的 dlazy CLI 音频/TTS 模型。
Trigger Keywords / 触发关键词
- generate audio
- text to speech, TTS
- generate music, sound effect
Authentication
All requests require a dLazy API key. The recommended way to authenticate is dlazy login:
dlazy login
This runs a device-code flow (also works in remote shells) and automatically saves your API key to the local CLI config — no manual copy/paste required.
Alternative: Set the Key Manually
If you already have an API key, you can save it directly:
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 Manually
- Sign in or create an account at dlazy.com
- Go to dlazy.com/dashboard/organization/api-key
- 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 to1.2.3in this skill's install spec) - Homepage: dlazy.com
You can install on demand without persisting a global binary by running:
npx @dlazy/[email protected]
Or, if you prefer a global install, the skill's metadata.clawdbot.install field declares the exact pinned version (npm install -g @dlazy/[email protected]). 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 (
files.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
files.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.
Piping Between Commands
Every dlazy invocation prints a JSON envelope on stdout. Any flag value can be a pipe reference that pulls from the upstream command's envelope, so you can chain steps without copying URLs by hand.
| Reference | Resolves to |
|---|---|
- | Upstream's natural value for this field (scalar or array) |
@N | The N-th output's primary value (e.g. @0 = first output url) |
@N. | Drill into the N-th output (@0.url, @1.meta.fps) |
@* | All outputs' primary values as an array |
@stdin | The whole upstream JSON envelope |
@stdin: | Jsonpath into the whole envelope (@stdin:result.outputs[0].url) |
Examples
# Generate an image and feed its url straight into image-to-video
dlazy seedream-4.5 --prompt "a red fox in snow" \
| dlazy kling-v3 --image - --prompt "fox starts running"
# Generate an image, then add TTS narration over a still
dlazy seedream-4.5 --prompt "lighthouse at dawn" \
| dlazy keling-tts --text "Welcome to the coast." --image @0.url
# Fan-out: pass every upstream output url into a batch step
dlazy seedream-4.5 --prompt "city skyline" --n 4 \
| dlazy superres --images @*
Required flags can be entirely sourced from the pipe —
--field -satisfies the requirement when an upstream value exists. If stdin is empty, the CLI fails withcode: "no_stdin".
Usage
This skill handles all audio generation requests by selecting the best dlazy audio model.
Available Audio Models
dlazy doubao-tts: ByteDance Doubao speech synthesis model. Supports multiple languages, voices, and highly natural streaming audio output, suitable for news broadcasts and audiobooks.dlazy elevenlabs-dialogue: ElevenLabs eleven_v3 multi-voice dialogue: assign a different voice per line (up to 10) and render the whole conversation in one shot. Supports audio tags like [giggling], [whispers] — great for character dialogue, podcasts, and short skits. Before picking a voice, you can search for the right one via elevenlabs-search.dlazy elevenlabs-music: ElevenLabs music_v1 model — generates 10–300s original music from a natural-language prompt. Good for BGM, ads, and short-video soundtracks.dlazy elevenlabs-search: Search the ElevenLabs voice library by keyword, source, and category. Returns a playable preview for each matched voice so you can pick the right one before running TTS. Search with ONE short English descriptor (deep / young / narrative); extra words narrow the match and full sentences usually return nothing.dlazy elevenlabs-sfx: ElevenLabs text-to-sound model — generates 1–22s short sound effects from a description. Suitable for foley, ambience, alerts, and game SFX.dlazy elevenlabs-tts: ElevenLabs eleven_v3 text-to-speech with 12 curated multilingual voices and stability/similarity/style controls. Great for dubbing, audiobooks, and character dialog. Before picking a voice, you can search for the right one via elevenlabs-search.dlazy elevenlabs-voice-clone: ElevenLabs Instant Voice Cloning (IVC). Upload a clean voice sample to clone a custom voice usable with ElevenLabs TTS.dlazy gemini-2.5-tts: Gemini-powered high-quality text-to-speech. Supports bilingual (EN/CN) and various emotional voices.dlazy keling-sfx: Sound effect generation model: supports text-to-SFX and matching SFX/BGM for reference videos. Suitable for foley, ambient sounds, and short video audio completion.dlazy keling-tts: Text-to-speech model (TTS), supports language, voice, speed, and output format settings. Suitable for dubbing, audiobooks, and voice broadcasts.dlazy kling-audio-clone: Custom voice (Kling), cloned voice used for dubbing or binding to subjects.dlazy qwen-audio-clone: Alibaba Bailian qwen3-tts voice cloning. Upload a clean voice sample to clone a custom voice usable in subsequent TTS calls.dlazy qwen-tts: Alibaba Bailian qwen3-tts text-to-speech. Choose from curated system voices (including dialects) or design a custom voice from a natural-language description.dlazy 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.dlazy vidu-audio-clone: Clone a real human voice and use it to read the specified text.
CRITICAL INSTRUCTION FOR AGENT:
- Select the most appropriate audio model.
- Run
dlazy -hto check parameters. - Execute the command.
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 ' 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:
- 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- 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 usingdlazy auth setand resume the task.
Tips
Visit https://dlazy.com for more information.
常见问题
- 必须配置 API Key 吗?
- 必须。可运行 `dlazy login` 完成设备码登录,或用 `dlazy auth set YOUR_API_KEY` 手动保存,也支持通过环境变量 `DLAZY_API_KEY` 临时传入。Key 与你的 dLazy 组织绑定,可在控制台随时轮换或撤销。
- 支持哪些音频模型?
- 可路由至 doubao-tts、elevenlabs-tts、elevenlabs-dialogue、elevenlabs-music、elevenlabs-sfx、elevenlabs-search、elevenlabs-voice-clone、gemini-2.5-tts、keling-tts、keling-sfx、kling-audio-clone、qwen-tts、qwen-audio-clone、suno-music、vidu-audio-clone。
- 生成结果能和其他 dlazy 命令串联吗?
- 可以。每次调用都会在 stdout 打印 JSON 信封,可以使用 `-`、`@0.url`、`@*`、`@stdin:result.outputs[0].url` 等管道引用,把上游输出直接传给下一步而无需复制链接。
相关技能
根据提示词自动挑选最合适的 dlazy CLI 图片模型,并执行生成命令。
根据提示词自动挑选视频模型,支持文生视频、图生视频、首尾帧、数字人与对口型。
Generate customized speech that highly restores the timbre by uploading reference audio using Kling Audio Clone. 使用可灵 (Kling) 声音克隆模型,通过上传参考音频,生成高度还原该音色的定制语音。
按固定 7 步结构生成具备反差钩子、故事感和金句收尾的短视频口播文案。
Generate multilingual, highly natural audio using Gemini 2.5 text-to-speech. 使用 Gemini 2.5 强大的文本转语音能力,生成多语言、高自然度的音频。
dlazy 的更多技能
浏览全部技能按意图把图像、视频、音频请求分发到合适的 dlazy CLI 模型。