dlazy-elevenlabs-stt

English · 中文

基于 ElevenLabs scribe_v1 的语音转文字（STT）能力，支持自动语言检测与可选的说话人角色分离（speaker diarization）。适用于字幕生成、语音转录及会议纪要整理等场景。

触发关键词

• elevenlabs-stt

认证方式

所有请求均需提供 dLazy API 密钥。推荐的认证方式为：

dlazy login

该命令将启动设备码（device-code）认证流程（亦可在远程终端中使用），并自动将您的 API 密钥保存至本地 CLI 配置文件中，无需手动复制粘贴。

替代方案：手动设置密钥

若您已拥有 API 密钥，可直接通过以下命令保存：

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.2.3 版本）
• 官网: dlazy.com

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

npx @dlazy/cli@1.2.3 

若您倾向全局安装，该技能的 metadata.clawdbot.install 字段已声明精确锁定版本（即执行 npm install -g @dlazy/cli@1.2.3）。安装前请务必查阅 GitHub 源码。

工作原理

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

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

这是标准的 SaaS 架构模式；该技能自身不额外访问网络或文件系统资源，所有 I/O 行为均由 dLazy CLI 统一管理。完整服务条款详见 dlazy.com。

使用方法

代理（AGENT）关键指令： 请执行 dlazy elevenlabs-stt 获取结果。

dlazy elevenlabs-stt -h

选项：
  --audio_url [audio_url]              音频 URL [音频：URL 或本地路径]
  --language_code [language_code]      语言代码 [默认: zh]（可选值："zh", "en"）
  --diarize [diarize]                  启用说话人角色分离 [默认: false]
  --dry-run                            打印请求载荷（payload）及预估费用，不实际调用 API
  --no-wait                            异步任务立即返回 generateId
  --timeout                   异步任务等待完成的最大秒数（默认: "1800"）
  -h, --help                           显示该命令的帮助信息

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

输出格式

{
  "ok": true,
  "result": {
    "tool": "elevenlabs-stt",
    "modelId": "elevenlabs-stt",
    "outputs": [
      {
        "type": "json",
        "id": "o_xxxxxxxx",
        "value": {}
      }
    ]
  }
}

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

示例

dlazy elevenlabs-stt --prompt 'prompt content'

错误处理

代理（AGENT）关键指令：

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

提示

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