跳至内容
登录注册
联系销售团队登录

推出 ElevenLabs CLI v1

作者
Min Kim
Paul Asjes
Tadas Petra
发布时间
最近更新

收听收听本文

今天，我们正式推出 ElevenLabs CLI v1，将 ElevenLabs API 直接带入终端。

编程智能体早已活跃在终端中：运行命令、读取结果，甚至还能订午餐。ElevenLabs CLI 以智能体优先为设计理念，提供文档完善的命令和易于解析、串联的结构化 JSON 结果。它还提供 --dry-run 模式，可在操作影响工作区前预览结果。

CLI 还将基础设施即代码式的智能体管理带到 ElevenAgents。将工作区中的所有智能体拉取为本地配置文件，像编辑代码库其他部分一样编辑它们，预览精确差异，再手动或通过编程智能体推送到生产环境。

在 macOS 上安装

brew install elevenlabs/tap/elevenlabs

Windows

scoop bucket add elevenlabs https://github.com/elevenlabs/scoop-bucket
scoop install elevenlabs

cURL

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.sh | sh

一个界面，使用整个平台

我们 OpenAPI 规范 中发布的每个 ElevenLabs API 端点，都可作为子命令使用：

# list every agent in your workspace as structured JSON 
elevenlabs agents list --format json

# compose a song from a prompt
elevenlabs music compose --prompt "lo-fi track for a rainy afternoon" --output track.mp3

# speak a sentence and save the audio
elevenlabs text-to-speech convert --voice-id gPPH6SLdL8XSX6GNJ40G --text "Hello from the CLI" --output hello.mp3

智能体即代码

智能体即代码将智能体配置视同应用代码。你在磁盘上的文件中工作，CLI 会让它们与工作区保持同步。整个流程只需 3 条命令。

elevenlabs agents pull              # every agent in your workspace becomes a local config file
# edit a config: change the greeting, swap the voice, update the prompt
elevenlabs agents push --dry-run    # preview exactly what would change, without changing anything
elevenlabs agents push              # apply

同样的流程也适用于生产环境。分支可将开发与生产环境分开：开发分支可使用测试电话号码和成本更低的 LLM，生产环境则使用真实号码和前沿模型。对于新项目，elevenlabs agents init 可搭建完整项目结构，并为客户支持等常见配置提供起始模板。

智能体数量不多时，仪表板尚可管理。但当你需要管理分布在数百个客户组织中的大量智能体，或从其他平台批量迁移智能体时，只有文件和版本控制这一工作流能满足扩展需求。

为编程智能体和开发者打造

智能体使用 CLI 时，失败方式与人不同。它无法回答交互式提示，会不断重试，并从错误信息中获取线索。CLI 围绕这一现实设计。

--help 面向人，--schema 面向智能体。每条 API 命令都会输出机器可读的契约，包括带类型的输入、每项输入的位置、必填项以及响应的确切结构。这让智能体无需猜测即可构建有效调用。

$ elevenlabs text-to-speech convert --schema
{
  "operation": "text-to-speech.convert",
  "description": "Create speech",
  "binaryResponse": true,
  "input": {
    "properties": {
      "text": { "location": "body", "type": "string" },
      "voice_id": { "location": "path", "type": "string" },
      ...
    },
    "required": ["text", "voice_id"]
  }
}

错误信息也能为智能体提供可用线索。智能体收到的是可解析的 JSON 错误信息；通过 TTY 检测到真人用户时，则显示纯文本错误信息。两者都包含修复错误的说明。

以下命令无效：

$ elevenlabs text-to-speech convert --text "Hello from the CLI"

智能体会收到以下错误信息：

$ elevenlabs text-to-speech convert --text "Hello from the CLI"
{
  "error": {
    "code": 400,
    "message": "Required parameter 'voice_id' is missing. Provide it via --voice-id or --params",
    "reason": "validationError"
  }
}

而真人用户看到的错误信息更易读，并附有解决问题的提示：

error[validation]:
 Required parameter 'voice_id' is missing. Provide it via --voice-id or --params
 Try `elevenlabs text-to-speech convert --help`

skills 开箱即用

--help 和 --schema 是 CLI 的内置手册。但 skills 更进一步，可教会编程智能体完整工作流，例如如何构建智能体、生成语音或转录通话。

将它们安装到项目中：

elevenlabs generate-skills

智能体早已活跃在终端中。现在，整个 ElevenLabs 也进入了终端。安装 CLI，将 skills 交给智能体，看看它能交付什么。通过文档开始。

相关内容

用高质量 AI 音频创作

联系销售团队注册