ElevenLabs CLI

ElevenLabs 正式推出 ElevenLabs CLI v1，这是一款命令行工具，旨在将 ElevenLabs 的全套 API 功能直接集成到开发者的终端环境中。这款工具不仅服务于人类开发者，更以“代理优先”（Agent-First）为设计理念，为编码代理（Coding Agents）提供了结构化、可解析且易于自动化的交互接口。

核心亮点

1. 代理优先设计 (Agent-First)

CLI 的每一个命令都经过精心设计，以适应自动化工作流：

• 结构化输出：支持 --format json，提供机器可读的结构化数据，便于代理解析和链接后续操作。
• 机器可读契约：通过 --schema 参数，每个 API 命令都会输出详细的输入类型、必填项及响应结构，让代理无需猜测即可构建有效调用。
• 智能错误处理：
  • 对人类：显示易读的纯文本错误信息及修复建议。
  • 对代理：返回可解析的 JSON 错误对象，包含错误代码、原因及具体修复指令，帮助代理自我纠正。

2. 代理即代码 (Agents-as-Code)

将代理配置视为代码库的一部分，实现版本控制与协作：

• 拉取与同步：使用 elevenlabs agents pull 将云端代理配置拉取为本地文件。
• 版本控制：像编辑代码一样修改代理提示词、语音设置等，并通过 Git 进行版本管理。
• 安全推送：使用 --dry-run 预览变更差异，确认无误后通过 push 应用到生产环境。
• 分支管理：支持开发与生产环境分离，例如在开发分支使用测试号码和低成本模型，在生产环境使用真实资源。

3. 全平台 API 覆盖

OpenAPI 规范中的每一个 ElevenLabs 端点都对应一个子命令：

• 文本转语音：elevenlabs text-to-speech convert --voice-id <id> --text "Hello" --output hello.mp3
• 音乐创作：elevenlabs music compose --prompt "lo-fi track" --output track.mp3
• 代理管理：elevenlabs agents list --format json

4. 内置技能 (Skills)

通过 elevenlabs generate-skills，可以将完整的工作流指南（如如何构建代理、生成语音、转录通话）安装到项目中，进一步赋能编码代理，使其能够独立完成复杂任务。

快速安装

macOS

brew install elevenlabs/tap/elevenlabs

Windows

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

Linux / cURL

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

适用场景

• 自动化工作流：在 CI/CD 管道中集成语音生成或代理部署。
• 大规模代理管理：通过代码版本控制管理成百上千个代理配置，避免手动操作仪表盘的低效与错误。
• 编码代理集成：让 Cursor、Claude Code 等代理直接在终端中调用 ElevenLabs 服务，实现从代码到语音的无缝闭环。
• 快速原型开发：通过命令行快速测试不同的提示词、语音模型及音乐风格。