dlazy-doubao-tts

English · 中文

使用 Doubao TTS 将文本合成为自然、流畅的语音。

触发关键词

• doubao tts
• text to speech
• generate speech
• voice broadcast

身份验证

所有请求均需提供 dLazy API 密钥，通过 CLI 进行配置：

dlazy auth set YOUR_API_KEY

CLI 会将密钥保存至您的用户配置目录（macOS/Linux 下为 ~/.dlazy/config.json，Windows 下为 %USERPROFILE%.dlazyconfig.json），并限制文件权限仅对当前操作系统用户可见。您也可在每次调用时通过 DLAZY_API_KEY 环境变量传入密钥。

获取您的 API 密钥

1. 访问 dlazy.com 并登录或注册账户
2. 进入 dlazy.com/dashboard/organization/api-key
3. 复制“API Key”区域中显示的密钥

每个密钥均绑定至您的 dLazy 组织，且可在同一控制台中随时轮换或撤销。

关于与来源

• CLI 源代码: github.com/dlazyai/cli
• 维护者: dlazyai
• npm 包: @dlazy/cli（本技能安装规范中固定为 1.0.9 版本）
• 官网: dlazy.com

您可通过以下命令按需运行，无需全局安装二进制文件：

npx @dlazy/cli@1.0.9 

或者，若您倾向全局安装，该技能的 metadata.clawdbot.install 字段已声明确切的固定版本（即执行 npm install -g @dlazy/cli@1.0.9）。请在安装前审阅 GitHub 源码。

工作原理

本技能是 dLazy 托管 API 的轻量级客户端。当您调用它时：

• 您提供的提示词与参数将被发送至 dLazy API 接口（api.dlazy.com）进行推理。
• 您传入图像 / 视频 / 音频字段的任何本地文件路径，都将上传至 dLazy 媒体存储（files.dlazy.com），以便模型读取——该流程与任意基于云的生成类 API 一致。
• API 返回的生成结果 URL 均托管于 files.dlazy.com。

这是标准的 SaaS 模式；该技能自身不直接访问网络或文件系统资源，其能力完全依赖于 dLazy CLI 已实现的功能。完整服务条款详见 dlazy.com。

使用方法

代理关键指令： 请运行 dlazy doubao-tts 命令以获取结果。

dlazy doubao-tts -h

Options:
  --prompt [prompt]                    提示词
  --voice_language [voice_language]    语音语言 [默认: zh-cn]（可选值: "zh-cn", "en"）
  --voiceId [voiceId]                  语音 ID。选项取决于 "voice_language"。当 voice_language="zh-cn" 时：zh_female_vv_uranus_bigtts (Vivi 2.0)，zh_female_xiaohe_uranus_bigtts (小何 2.0)，zh_male_m191_uranus_bigtts (云舟 2.0)，zh_male_taocheng_uranus_bigtts (小天 2.0)，zh_male_liufei_uranus_bigtts (刘飞 2.0)，zh_male_sophie_uranus_bigtts (魅力苏菲 2.0)，zh_female_qingxinnvsheng_uranus_bigtts (清新女声 2.0)，zh_female_cancan_uranus_bigtts (知性灿灿 2.0)，zh_female_sajiaoxuemei_uranus_bigtts (撒娇学妹 2.0)，zh_female_tianmeixiaoyuan_uranus_bigtts (甜美小源 2.0)，zh_female_tianmeitaozi_uranus_bigtts (甜美桃子 2.0)，zh_female_shuangkuaisisi_uranus_bigtts (爽快思思 2.0)，zh_female_peiqi_uranus_bigtts (佩奇猪 2.0)，zh_female_linjianvhai_uranus_bigtts (邻家女孩 2.0)，zh_male_shaonianzixin_uranus_bigtts (少年梓辛/Brayan 2.0)，zh_male_sunwukong_uranus_bigtts (猴哥 2.0)，zh_female_yingyujiaoxue_uranus_bigtts (Tina老师 2.0)，zh_female_kefunvsheng_uranus_bigtts (暖阳女声 2.0)，zh_female_xiaoxue_uranus_bigtts (儿童绘本 2.0)，zh_male_dayi_uranus_bigtts (大壹 2.0)，zh_female_mizai_uranus_bigtts (黑猫侦探社咪仔 2.0)，zh_female_jitangnv_uranus_bigtts (鸡汤女 2.0)，zh_female_meilinvyou_uranus_bigtts (魅力女友 2.0)，zh_female_liuchangnv_uranus_bigtts (流畅女声 2.0)，zh_male_ruyayichen_uranus_bigtts (儒雅逸辰 2.0)，saturn_zh_female_keainvsheng_tob (可爱女生)，saturn_zh_female_tiaopigongzhu_tob (调皮公主)，saturn_zh_male_shuanglangshaonian_tob (爽朗少年)，saturn_zh_male_tiancaitongzhuo_tob (天才同桌)，saturn_zh_female_cancan_tob (知性灿灿)，saturn_zh_female_qingyingduoduo_cs_tob (轻盈朵朵 2.0)，saturn_zh_female_wenwanshanshan_cs_tob (温婉珊珊 2.0)，saturn_zh_female_reqingaina_cs_tob (热情艾娜 2.0)；当 voice_language="en" 时：timen_male_tim_uranus_bigtts (Timen)，en_female_dacey_uranus_bigtts (Dacey)，en_female_stokie_uranus_bigtts (Stokie) [默认: zh_female_shuangkuaisisi_uranus_bigtts] [选项随 --voice_language 变化；voice_language=zh 时：zh_female_vv_uranus_bigtts (Vivi 2.0)，zh_female_xiaohe_uranus_bigtts (小何 2.0)，zh_male_m191_uranus_bigtts (云舟 2.0)，zh_male_taocheng_uranus_bigtts (小天 2.0)，zh_male_liufei_uranus_bigtts (刘飞 2.0)，zh_male_sophie_uranus_bigtts (魅力苏菲 2.0)，zh_female_qingxinnvsheng_uranus_bigtts (清新女声 2.0)，zh_female_cancan_uranus_bigtts (知性灿灿 2.0)，zh_female_sajiaoxuemei_uranus_bigtts (撒娇学妹 2.0)，zh_female_tianmeixiaoyuan_uranus_bigtts (甜美小源 2.0)，zh_female_tianmeitaozi_uranus_bigtts (甜美桃子 2.0)，zh_female_shuangkuaisisi_uranus_bigtts (爽快思思 2.0)，zh_female_peiqi_uranus_bigtts (佩奇猪 2.0)，zh_female_linjianvhai_uranus_bigtts (邻家女孩 2.0)，zh_male_shaonianzixin_uranus_bigtts (少年梓辛/Brayan 2.0)，zh_male_sunwukong_uranus_bigtts (猴哥 2.0)，zh_female_yingyujiaoxue_uranus_bigtts (Tina老师 2.0)，zh_female_kefunvsheng_uranus_bigtts (暖阳女声 2.0)，zh_female_xiaoxue_uranus_bigtts (儿童绘本 2.0)，zh_male_dayi_uranus_bigtts (大壹 2.0)，zh_female_mizai_uranus_bigtts (黑猫侦探社咪仔 2.0)，zh_female_jitangnv_uranus_bigtts (鸡汤女 2.0)，zh_female_meilinvyou_uranus_bigtts (魅力女友 2.0)，zh_female_liuchangnv_uranus_bigtts (流畅女声 2.0)，zh_male_ruyayichen_uranus_bigtts (儒雅逸辰 2.0)，saturn_zh_female_keainvsheng_tob (可爱女生)，saturn_zh_female_tiaopigongzhu_tob (调皮公主)，saturn_zh_male_shuanglangshaonian_tob (爽朗少年)，saturn_zh_male_tiancaitongzhuo_tob (天才同桌)，saturn_zh_female_cancan_tob (知性灿灿)，saturn_zh_female_qingyingduoduo_cs_tob (轻盈朵朵 2.0)，saturn_zh_female_wenwanshanshan_cs_tob (温婉珊珊 2.0)，saturn_zh_female_reqingaina_cs_tob (热情艾娜 2.0)；voice_language=en 时：timen_male_tim_uranus_bigtts (Timen)，en_female_dacey_uranus_bigtts (Dacey)，en_female_stokie_uranus_bigtts (Stokie)
--speed_ratio [speed_ratio]          语速比例 [默认: 1.0]（可选值: "0.8", "1.0", "1.2", "1.5", "2.0"）
--dry-run                            打印请求载荷及费用预估，但不实际调用 API
--no-wait                            对异步任务立即返回 generateId
--timeout                   异步任务完成等待最大秒数（默认: "1800"）
-h, --help                           显示命令帮助信息


任意标志位也支持管道引用语法 —— -（自动从上游 stdin 获取）、@N（第 N 个输出）、@N.path（对输出执行 JSONPath 查询）、@*（全部主值）、@stdin / @stdin:path（完整信封）。详情请参阅 dlazy --help。

输出格式
{
  "ok": true,
  "result": {
    "tool": "doubao-tts",
    "modelId": "doubao-tts",
    "outputs": [
      {
        "type": "image",
        "id": "o_xxxxxxxx",
        "url": "https://files.dlazy.com/result.png",
        "mimeType": "image/png"
      }
    ]
  }
}


异步任务（启用 --no-wait 时）将返回 outputs: [] 并附带 task: { generateId, status } 字段。请使用 dlazy status  --wait 进行轮询。

命令示例
# 基础调用：
dlazy doubao-tts --prompt 'prompt text'

# 复杂调用：
dlazy doubao-tts --prompt 'prompt text'

错误处理



状态码
错误类型
示例消息



401
未授权（缺少 API 密钥）
ok: false, code: "unauthorized", message: "API key is missing or invalid"


501
缺失必需参数
error: required option '--prompt ' not specified


502
本地文件读取失败
Error: Image file/Video file not found: C:pathtoyourfile


503
API 请求失败（余额不足）
ok: false, code: "insufficient_balance"


503
API 请求失败（服务端错误）
HTTP status code error (500 server crash)


504
异步任务执行失败
=== Generation Failed === / {后端返回的具体错误原因，例如 "Prompt violates safety policy"}



代理关键指令：

若执行结果返回 code: "insufficient_balance"，您必须明确告知用户余额不足，并引导其前往 https://dlazy.com/dashboard/organization/settings?tab=credits 充值；
若执行结果返回 code: "unauthorized" 或提示缺少 API 密钥，您必须告知用户前往 https://dlazy.com/dashboard/organization/api-key 获取密钥，并通过 dlazy auth set  命令保存后重试任务。


提示
更多信息请访问 https://dlazy.com。