mcpField
P
pp-elevenlabs

pp-elevenlabs

github.com/mvanhorn创意与媒体2.1k163 次安装今天更新
代码仓库

关于 pp-elevenlabs

此 skill 指导 Agent 使用 elevenlabs-pp-cli 查找语音、解析文本转语音设置并生成音频文件，也可制作多说话人对话。

主要功能

  1. 01查找自有及共享语音
  2. 02解析语音和生成设置
  3. 03将文本渲染为音频文件
  4. 04制作带说话人标签的对话
  5. 05管理 Convai Agent 和资源

适用场景

  1. 01生成音频前选择语音
  2. 02将文本制作成音频文件
  3. 03为对话分配语音并生成音频

MCP 相关

CLI 的 Convai 命令可在工作区创建和管理 MCP 服务配置及 MCP 工具审批。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/mvanhorn/printing-press-library --skill pp-elevenlabs

安装后在 Claude Code 中输入/pp-elevenlabs确认已加载。

详细介绍

Elevenlabs — Printing Press 命令行工具

前提条件：安装 CLI

此技能使用 elevenlabs-pp-cli 二进制文件。**调用此技能中的任何命令前，必须确认 CLI 已安装。**如果尚未安装，请先安装：

  1. 通过 Printing Press 安装程序安装。在 macOS/Linux 上，默认将二进制文件安装到 $HOME/.local/bin；在 Windows 上，安装到 %LOCALAPPDATA%\Programs\PrintingPress\bin： 
    npx -y @mvanhorn/printing-press-library install elevenlabs --cli-only
  2. 验证：elevenlabs-pp-cli --version
  3. 确保报告的安装目录已添加到将调用此技能的 Agent/运行时的 $PATH 中。

如果 npx 安装失败（例如没有 Node、处于离线状态等），请改用直接 Go 安装（需要 Go 1.26.6 或更高版本）：

go install github.com/mvanhorn/printing-press-library/library/ai/elevenlabs/cmd/elevenlabs-pp-cli@latest

如果安装后 --version 报告“command not found”，说明运行时无法在 $PATH 中找到二进制文件目录。在验证成功之前，请勿继续执行此技能的命令。

独特功能

对于此 API，其他任何工具都不具备这些功能。

Agent 音频规划

  • voice discover — 通过一条精简、以 JSON 为主的命令，搜索自有和共享的 ElevenLabs 语音。

    Agent 无需翻阅不兼容的原始端点，即可在生成前选择语音。

    elevenlabs-pp-cli voice discover --source all --limit 5 --agent

  • tts resolve — 在渲染前解析语音、模型、输出格式、默认设置和订阅上下文。

    Agent 可以低成本验证生成选项，避免浪费音频配额。

    elevenlabs-pp-cli tts resolve --voice JBFqnCBsd6RMkjVDRZzb --model auto --agent
音频产物工作流

  • tts render — 将文本渲染为音频文件，并输出包含文件路径、字节数、模型和语音的结构化清单。

    Agent 只需一步，即可获得持久化的音频产物和机器可读的元数据。

    elevenlabs-pp-cli tts render --voice JBFqnCBsd6RMkjVDRZzb --text 'Hello from ElevenLabs.' --out hello.mp3 --agent

  • dialogue cast — 解析发言者与语音的对应关系，并保存音频，以渲染标注了发言者的对话内容。

    Agent 无需手动构造 JSON 语音 ID 负载，即可根据脚本生成多发言者对话。

    elevenlabs-pp-cli dialogue cast --line narrator='Welcome.' --cast narrator=JBFqnCBsd6RMkjVDRZzb --out dialogue.mp3 --agent

命令参考

audio-isolation — 管理音频隔离

  • elevenlabs-pp-cli audio-isolation audio_isolation — 去除音频中的背景噪声
  • elevenlabs-pp-cli audio-isolation delete-history-item — 删除指定的音频隔离历史记录项及相关媒体文件。
  • elevenlabs-pp-cli audio-isolation get-history — 返回所有音频隔离生成记录的列表。
  • elevenlabs-pp-cli audio-isolation stream — 去除音频中的背景噪声并流式传输结果

audio-native — 管理 audio native

  • elevenlabs-pp-cli audio-native create-project — 创建启用了 Audio Native 的项目，可选择启动转换，并返回项目 ID 和可嵌入的 HTML 代码片段。
  • elevenlabs-pp-cli audio-native update-content-from-url — 查找与提供的 URL 匹配的 AudioNative 项目，从该 URL 提取内容，更新项目内容，...

convai — 管理 convai

  • elevenlabs-pp-cli convai add-documentation-to-knowledge-base — 上传文件或引用网页，将其用作共享知识库的一部分

  • elevenlabs-pp-cli convai add-mcp-server-tool-approval-route — 使用按工具审批模式时，为特定 MCP 工具添加审批。

  • elevenlabs-pp-cli convai add-mcp-tool-config-override-route — 为特定 MCP 工具创建配置覆盖。

  • elevenlabs-pp-cli convai add-tool-route — 向工作区中的可用工具添加新工具。

  • elevenlabs-pp-cli convai agent-testing-bulk-move-route — 将多个测试或文件夹从一个文件夹移动到另一个文件夹。

  • elevenlabs-pp-cli convai assign-conversation-tags-route — 为对话分配一个或多个对话标签。已分配的标签会被忽略。标签必须属于...

  • elevenlabs-pp-cli convai cancel-batch-call — 取消正在运行的批量呼叫，并将所有接收者的状态设为已取消。

  • elevenlabs-pp-cli convai cancel-file-upload-route — 从对话中移除文件上传。仅当该文件尚未在对话中使用时才可执行。

  • elevenlabs-pp-cli convai create-agent-deployment-route — 为 Agent 创建新的部署

  • elevenlabs-pp-cli convai create-agent-draft-route — 为 Agent 创建新的草稿

  • elevenlabs-pp-cli convai create-agent-response-test-route — 创建新的 Agent 响应测试。

  • elevenlabs-pp-cli convai create-agent-route — 根据配置对象创建 Agent

  • elevenlabs-pp-cli convai create-agent-test-folder-route — 创建用于整理 Agent 测试的文件夹。

  • elevenlabs-pp-cli convai create-batch-call — 提交批量呼叫请求，为多个接收者安排呼叫。

  • elevenlabs-pp-cli convai create-branch-route — 根据任意分支的指定版本创建新分支

  • elevenlabs-pp-cli convai create-conversation-tag-route — 为工作区创建新的对话标签。

  • elevenlabs-pp-cli convai create-environment-variable — 为工作区创建新的环境变量

  • elevenlabs-pp-cli convai create-file-document-route — 根据上传的文件创建知识库文档。

  • elevenlabs-pp-cli convai create-folder-route — 创建用于归类文档的文件夹。

  • elevenlabs-pp-cli convai create-mcp-server-route — 在工作区中创建新的 MCP 服务配置。

  • elevenlabs-pp-cli convai create-phone-number-route — 从服务提供商配置（Twilio 或 SIP 中继）导入电话号码

  • elevenlabs-pp-cli convai create-secret-route — 为工作区创建新的密钥

  • elevenlabs-pp-cli convai create-text-document-route — 创建包含所提供文本的知识库文档。

  • elevenlabs-pp-cli convai create-url-document-route — 抓取指定网页并据此创建知识库文档。

  • elevenlabs-pp-cli convai delete-agent-draft-route — 删除 Agent 的草稿

  • elevenlabs-pp-cli convai delete-agent-route — 删除 Agent

  • elevenlabs-pp-cli convai delete-agent-test-folder-route — 根据 ID 删除 Agent 测试文件夹。使用 force=true 可删除非空文件夹及其所有内容。

  • elevenlabs-pp-cli convai delete-batch-call — 永久删除批量呼叫及所有接收者记录。对话仍保留在历史记录中。

  • elevenlabs-pp-cli convai delete-chat-response-test-route — 根据 ID 删除 Agent 响应测试。

  • elevenlabs-pp-cli convai delete-conversation-route — 删除指定对话

  • elevenlabs-pp-cli convai delete-conversation-tag-route — 删除对话标签。仅限标签所有者或工作区管理员操作。

  • elevenlabs-pp-cli convai delete-knowledge-base-document — 从知识库中删除文档或文件夹。

  • elevenlabs-pp-cli convai delete-mcp-server-route — 从工作区中删除指定的 MCP 服务配置。

  • elevenlabs-pp-cli convai delete-phone-number-route — 根据 ID 删除电话号码

  • elevenlabs-pp-cli convai delete-rag-index — 删除知识库文档的 RAG 索引。

  • elevenlabs-pp-cli convai delete-secret-route — 删除未被使用的工作区密钥

  • elevenlabs-pp-cli convai delete-tool-route — 从工作区中删除工具。

  • elevenlabs-pp-cli convai delete-whatsapp-account — 删除 WhatsApp 账户

  • elevenlabs-pp-cli convai duplicate-agent-route — 通过复制现有 Agent 创建新的 Agent

  • elevenlabs-pp-cli convai get-agent-knowledge-base-size — 返回 Agent 知识库中的页面数量。

  • elevenlabs-pp-cli convai get-agent-knowledge-base-summaries-route — 根据 ID 获取多个知识库文档摘要。

  • elevenlabs-pp-cli convai get-agent-link-route — 获取当前用于与他人分享 Agent 的链接

  • elevenlabs-pp-cli convai get-agent-llm-expected-cost-calculation — 计算指定 Agent 预计需要的 LLM 令牌数量。

  • elevenlabs-pp-cli convai get-agent-response-test-route — 根据 ID 获取 Agent 响应测试。

  • elevenlabs-pp-cli convai get-agent-response-tests-summaries-route — 根据 ID 获取多个 Agent 响应测试。返回一个将测试 ID 映射到测试摘要的字典。

  • elevenlabs-pp-cli convai get-agent-route — 获取 Agent 的配置

  • elevenlabs-pp-cli convai get-agent-summaries-route — 返回指定 Agent 的摘要。

  • elevenlabs-pp-cli convai get-agent-test-folder-route — 根据 ID 获取 Agent 测试文件夹，包括其文件夹路径。

  • elevenlabs-pp-cli convai get-agent-topics-route — 返回指定 Agent 最近一次主题发现运行的结果。

  • elevenlabs-pp-cli convai get-agent-widget-route — 获取 Agent 的小组件配置

  • elevenlabs-pp-cli convai get-agents-route — 返回 Agent 列表及其元数据。

  • elevenlabs-pp-cli convai get-api-integration-docs — 获取所有提供了文档的集成的 MDX 文档。返回公开可用集成的文档...

  • elevenlabs-pp-cli convai get-batch-call — 获取批量呼叫的详细信息，包括所有接收者。

  • elevenlabs-pp-cli convai get-branch-route — 获取单个 Agent 分支的信息

  • elevenlabs-pp-cli convai get-branches-route — 返回 Agent 的分支列表

  • elevenlabs-pp-cli convai get-conversation-audio-route — 获取指定对话的录音

  • elevenlabs-pp-cli convai get-conversation-histories-route — 获取用户拥有的 Agent 的所有对话。可选择限定为特定 Agent。

  • elevenlabs-pp-cli convai get-conversation-history-route — 获取指定对话的详细信息

  • elevenlabs-pp-cli convai get-conversation-signed-link — 获取签名 URL，以便与需要授权的 Agent 开始对话

  • elevenlabs-pp-cli convai get-conversation-sip-messages — 获取与对话电话呼叫相关的 SIP 消息

  • elevenlabs-pp-cli convai get-conversation-tag-route — 根据 ID 获取对话标签。

  • elevenlabs-pp-cli convai get-conversation-users-route — 分页获取对话中的不同用户。

  • elevenlabs-pp-cli convai get-dashboard-settings-route — 获取工作区的 Convai 控制面板设置

  • elevenlabs-pp-cli convai get-documentation-chunk-from-knowledge-base — 获取 RAG 使用的特定文档片段的详细信息。

  • elevenlabs-pp-cli convai get-documentation-chunks-from-knowledge-base — 获取特定知识库文档的所有 RAG 分块。

  • elevenlabs-pp-cli convai get-documentation-from-knowledge-base — 获取构成 Agent 知识库的特定文档的详细信息

  • elevenlabs-pp-cli convai get-environment-variable — 根据 ID 获取特定环境变量

  • elevenlabs-pp-cli convai get-knowledge-base-content — 获取知识库中文档的全部内容

  • elevenlabs-pp-cli convai get-knowledge-base-dependent-agents — 获取依赖此知识库文档的 Agent 列表

  • elevenlabs-pp-cli convai get-knowledge-base-list-route — 获取可用知识库文档列表

  • elevenlabs-pp-cli convai get-knowledge-base-source-file-url — 获取签名 URL，以下载知识库中文件类型文档的原始源文件

  • elevenlabs-pp-cli convai get-live-count — 获取正在进行的对话的实时数量。

  • elevenlabs-pp-cli convai get-livekit-token — 获取用于实时通信的 WebRTC 会话令牌。

  • elevenlabs-pp-cli convai get-mcp-route — 从工作区中获取指定的 MCP 服务配置。

  • elevenlabs-pp-cli convai get-mcp-tool-config-override-route — 获取特定 MCP 工具的配置覆盖。

  • elevenlabs-pp-cli convai get-or-create-rag-indexes — 在单个请求中获取和／或创建多个知识库文档的 RAG 索引。最多 100 项...

  • elevenlabs-pp-cli convai get-phone-number-route — 根据 ID 获取电话号码详情

  • elevenlabs-pp-cli convai get-public-llm-expected-cost-calculation — 根据提供的值返回 LLM 模型列表及使用这些模型的预期费用。

  • elevenlabs-pp-cli convai get-rag-index-overview — 提供知识库文档所用 RAG 索引的总大小及其他信息

  • elevenlabs-pp-cli convai get-rag-indexes — 提供指定知识库文档的所有 RAG 索引信息。

  • elevenlabs-pp-cli convai get-secret-dependencies-route — 分页获取依赖特定密钥的资源列表，并按资源类型筛选。

  • elevenlabs-pp-cli convai get-secret-route — 根据 ID 获取工作区密钥

  • elevenlabs-pp-cli convai get-secrets-route — 获取用户的所有工作区密钥

  • elevenlabs-pp-cli convai get-settings-route — 获取工作区的 Convai 设置

  • elevenlabs-pp-cli convai get-signed-url-deprecated — 获取签名 URL，以便与需要授权的 Agent 开始对话

  • elevenlabs-pp-cli convai get-test-invocation-route — 根据 ID 获取测试调用。

  • elevenlabs-pp-cli convai get-tool-dependent-agents-route — 获取依赖此工具的 Agent 列表

  • elevenlabs-pp-cli convai get-tool-executions-route — 分页获取特定工具的执行记录列表。

  • elevenlabs-pp-cli convai get-tool-route — 获取工作区中可用的工具。

  • elevenlabs-pp-cli convai get-tools-route — 获取工作区中的所有可用工具。

  • elevenlabs-pp-cli convai get-version-metadata-route — 获取特定 Agent 版本的元数据

  • elevenlabs-pp-cli convai get-whatsapp-account — 获取 WhatsApp 账户

  • elevenlabs-pp-cli convai get-workspace-batch-calls — 获取当前工作区中的所有批量呼叫。

  • elevenlabs-pp-cli convai handle-sip-trunk-outbound-call — 通过 SIP 中继处理外呼

  • elevenlabs-pp-cli convai handle-twilio-outbound-call — 通过 Twilio 处理外呼

  • elevenlabs-pp-cli convai list-available-llms — 返回可与 Agent 配合使用的 LLM 模型列表，包括其功能以及任何...

  • elevenlabs-pp-cli convai list-chat-response-tests-route — 列出所有 Agent 响应测试，支持分页和可选的搜索筛选。

  • elevenlabs-pp-cli convai list-conversation-tags-route — 列出工作区的对话标签，按创建时间从新到旧排序。

  • elevenlabs-pp-cli convai list-environment-variables — 列出工作区的所有环境变量，并支持可选筛选

  • elevenlabs-pp-cli convai list-mcp-server-tools-route — 获取特定 MCP 服务配置中的所有可用工具。

  • elevenlabs-pp-cli convai list-mcp-servers-route — 获取工作区中的所有 MCP 服务配置。

  • elevenlabs-pp-cli convai list-phone-numbers-route — 获取所有电话号码

  • elevenlabs-pp-cli convai list-sip-messages — 获取电话号码的 SIP 消息

  • elevenlabs-pp-cli convai list-test-invocations-route — 列出所有测试调用，支持分页和可选的搜索筛选。

  • elevenlabs-pp-cli convai list-whatsapp-accounts — 列出所有 WhatsApp 账户

  • elevenlabs-pp-cli convai merge-branch-into-target — 将一个分支合并到目标分支

  • elevenlabs-pp-cli convai patch-agent-settings-route — 对 Agent 设置进行局部更新

  • elevenlabs-pp-cli convai post-agent-avatar-route — 设置在小组件中显示的 Agent 头像

  • elevenlabs-pp-cli convai post-conversation-feedback-route — 发送指定对话的反馈

  • elevenlabs-pp-cli convai post-knowledge-base-bulk-move-route — 将多个实体从一个文件夹移动到另一个文件夹。

  • elevenlabs-pp-cli convai post-knowledge-base-move-route — 将实体从一个文件夹移动到另一个文件夹。

  • elevenlabs-pp-cli convai rag-index-status — 如果文档尚未建立 RAG 索引，则会触发 RAG 索引任务；否则仅返回当前状态。

  • elevenlabs-pp-cli convai refresh-url-document-route — 通过从源 URL 重新获取内容，手动刷新 URL 文档。

  • elevenlabs-pp-cli convai register-twilio-call — 注册 Twilio 呼叫并返回用于连接呼叫的 TwiML

  • elevenlabs-pp-cli convai remove-mcp-server-tool-approval-route — 使用按工具审批模式时，移除特定 MCP 工具的审批。

  • elevenlabs-pp-cli convai remove-mcp-tool-config-override-route — 移除特定 MCP 工具的配置覆盖。

  • elevenlabs-pp-cli convai resubmit-tests-route — 重新提交测试调用中的指定测试运行。

  • elevenlabs-pp-cli convai retry-batch-call — 重试批量呼叫，再次呼叫失败和未响应的接收者。

  • elevenlabs-pp-cli convai run-agent-test-suite-route — 使用提供的配置对 Agent 运行选定的测试。如果提供了 Agent 配置，则会使用该配置...

  • elevenlabs-pp-cli convai run-conversation-analysis — 使用 Agent 当前的评估标准和数据收集设置分析对话。

  • elevenlabs-pp-cli convai run-conversation-simulation-route — 运行 Agent 与模拟用户之间的对话。

  • elevenlabs-pp-cli convai run-conversation-simulation-route-stream — 运行 Agent 与模拟用户之间的对话，并以流式方式返回响应。响应以流式方式返回...

  • elevenlabs-pp-cli convai search-knowledge-base-content-route — 对知识库文档内容进行模糊文本搜索

  • elevenlabs-pp-cli convai smart-search-conversation-messages-route — 根据语义相似度搜索对话转录文本，按含义和意图查找相关消息...

  • elevenlabs-pp-cli convai text-search-conversation-messages-route — 通过全文搜索和模糊搜索查找对话转录消息

  • elevenlabs-pp-cli convai unassign-conversation-tag-route — 从对话中移除单个对话标签。

  • elevenlabs-pp-cli convai update-agent-response-test-route — 根据 ID 更新 Agent 响应测试。

  • elevenlabs-pp-cli convai update-agent-test-folder-route — 更新 Agent 测试文件夹。目前仅支持更新文件夹名称。

  • elevenlabs-pp-cli convai update-branch-route — 更新 Agent 分支属性，例如归档状态和保护级别

  • elevenlabs-pp-cli convai update-conversation-tag-route — 更新对话标签的标题和／或描述。仅限标签所有者或工作区管理员操作。

  • elevenlabs-pp-cli convai update-dashboard-settings-route — 更新工作区的 Convai 控制面板设置

  • elevenlabs-pp-cli convai update-document-route — 更新文档名称和／或内容。

  • elevenlabs-pp-cli convai update-environment-variable — 替换环境变量的值。使用 null 可移除某个环境（production 除外）。

  • elevenlabs-pp-cli convai update-file-document-route — 更新文件文档的源文件。文档名称、内容和元数据将随之更新，以反映新的...

  • elevenlabs-pp-cli convai update-mcp-server-approval-policy-route — 更新 MCP 服务的审批策略配置。已弃用：请改用 PATCH /mcp-servers/{id} 端点。

  • elevenlabs-pp-cli convai update-mcp-server-config-route — 更新 MCP 服务的配置设置。

  • elevenlabs-pp-cli convai update-mcp-tool-config-override-route — 更新特定 MCP 工具的配置覆盖。

  • elevenlabs-pp-cli convai update-phone-number-route — 更新电话号码关联的 Agent

  • elevenlabs-pp-cli convai update-secret-route — 更新工作区中现有的密钥

  • elevenlabs-pp-cli convai update-settings-route — 更新工作区的 Convai 设置

  • elevenlabs-pp-cli convai update-tool-route — 更新工作区中可用的工具。

  • elevenlabs-pp-cli convai update-whatsapp-account — 更新 WhatsApp 账户

  • elevenlabs-pp-cli convai upload-file-route — 为对话上传图像或 PDF 文件。返回可用于引用该文件的唯一文件 ID...

  • elevenlabs-pp-cli convai whatsapp-outbound-call — 通过 WhatsApp 发起外呼

  • elevenlabs-pp-cli convai whatsapp-outbound-message — 通过 WhatsApp 发送外发消息 docs — 管理文档

  • elevenlabs-pp-cli docs — 重定向到 Mintlify

dubbing — 管理配音

  • elevenlabs-pp-cli dubbing add-language — 将给定的 ElevenLab Turbo V2/V2.5 语言代码添加到资源中。不会自动生成……
  • elevenlabs-pp-cli dubbing create — 将提供的音频或视频文件配音为指定语言。
  • elevenlabs-pp-cli dubbing create-clip — 在配音资源中创建一个新片段，为每种可用语言指定说话人的开始和结束时间……
  • elevenlabs-pp-cli dubbing create-speaker — 创建新说话人
  • elevenlabs-pp-cli dubbing delete — 删除配音项目。
  • elevenlabs-pp-cli dubbing delete-segment — 从配音中删除单个片段。
  • elevenlabs-pp-cli dubbing dub — 为整个资源或指定的片段／语言重新生成配音。将自动……
  • elevenlabs-pp-cli dubbing get-dubbed-metadata — 返回配音项目的元数据，包括项目是否仍在处理中
  • elevenlabs-pp-cli dubbing get-resource — 给定通过启用了 studio 的 /v1/dubbing 端点生成的配音 ID，返回配音资源。
  • elevenlabs-pp-cli dubbing get-similar-voices-for-speaker — 获取与说话人最相似的 10 种声音，包括声音 ID、名称、描述，以及在可能的情况下……
  • elevenlabs-pp-cli dubbing list-dubs — 列出你有权访问的配音。
  • elevenlabs-pp-cli dubbing migrate-segments — 将一个或多个片段的归属更改为其他说话人。
  • elevenlabs-pp-cli dubbing render — 使用最新的 Studio 状态为某种语言重新生成输出媒体。请确保所有片段都已……
  • elevenlabs-pp-cli dubbing transcribe — 为指定片段重新生成转录。不会自动重新生成翻译或配音。
  • elevenlabs-pp-cli dubbing translate — 为整个资源或指定的片段／语言重新生成翻译。将自动……
  • elevenlabs-pp-cli dubbing update-segment-language — 使用新文本和／或开始／结束时间修改单个片段。仅更新特定语言的值……
  • elevenlabs-pp-cli dubbing update-speaker — 修改与说话人关联的元数据，例如其声音。既可以使用声音克隆，也可以使用……

forced-alignment — 将音频文件与文本转录进行强制对齐，以获取精确到词语和字符级别的时间信息。响应为字符列表，其中包含每个字符相对于录音开始经过的毫秒数表示的开始和结束时间。

  • elevenlabs-pp-cli forced-alignment — 将音频文件与文本进行强制对齐。使用此端点获取……中每个字符和词语的时间信息

history — 管理历史记录

  • elevenlabs-pp-cli history delete-speech-item — 根据 ID 删除历史记录项
  • elevenlabs-pp-cli history download-speech-items — 下载一个或多个历史记录项。如果提供一个历史记录项 ID，我们将返回单个音频文件。如果提供多个……
  • elevenlabs-pp-cli history get-speech — 返回你生成的音频列表。
  • elevenlabs-pp-cli history get-speech-item-by-id — 获取历史记录项。

models — 访问平台的不同模型。

  • elevenlabs-pp-cli models — 获取可用模型列表。

music — 管理音乐

  • elevenlabs-pp-cli music compose-detailed — 根据提示词或作曲计划创作歌曲。
  • elevenlabs-pp-cli music compose-plan — 根据提示词生成作曲计划。
  • elevenlabs-pp-cli music generate — 根据提示词或作曲计划创作歌曲。
  • elevenlabs-pp-cli music separate-song-stems — 将音频文件拆分为单独的音轨。此端点可能延迟较高，具体取决于……
  • elevenlabs-pp-cli music stream-compose — 根据提示词或作曲计划流式创作歌曲。
  • elevenlabs-pp-cli music upload-song — 上传音乐文件，以便稍后用于修补。仅限有权访问……的企业客户端使用。
  • elevenlabs-pp-cli music video-to — 根据一个或多个视频文件生成背景音乐。视频将按顺序合并。可选描述和风格……

pronunciation-dictionaries — 管理发音词典

  • elevenlabs-pp-cli pronunciation-dictionaries add-from-file — 根据词典 .PLS 文件创建新的发音词典
  • elevenlabs-pp-cli pronunciation-dictionaries add-from-rules — 根据提供的规则创建新的发音词典。
  • elevenlabs-pp-cli pronunciation-dictionaries get-metadata — 列出你有权访问的发音词典及其元数据
  • elevenlabs-pp-cli pronunciation-dictionaries get-pronunciation-dictionary-metadata — 获取发音词典的元数据
  • elevenlabs-pp-cli pronunciation-dictionaries patch-pronunciation-dictionary — 部分更新发音词典，但不更改版本

service-accounts — 管理服务账户

  • elevenlabs-pp-cli service-accounts — 列出工作区中的所有服务账户

shared-voices — 管理共享语音

  • elevenlabs-pp-cli shared-voices — 获取共享语音列表。

similar-voices — 管理相似语音

  • elevenlabs-pp-cli similar-voices — 返回与所提供音频样本相似的共享语音列表。如果既未设置 similarity_threshold，也未设置 top_k，则……

single-use-token — 管理一次性令牌

  • elevenlabs-pp-cli single-use-token — 生成限时的一次性令牌，其中嵌入了供前端客户端使用的身份验证信息。

sound-generation — 管理音效生成

  • elevenlabs-pp-cli sound-generation — 使用最先进的音效……将文本转换为适用于视频、配音或视频游戏的音效。

speech-engine — 管理语音引擎

  • elevenlabs-pp-cli speech-engine create — 创建新的语音引擎资源
  • elevenlabs-pp-cli speech-engine delete — 删除语音引擎资源
  • elevenlabs-pp-cli speech-engine get — 获取语音引擎资源
  • elevenlabs-pp-cli speech-engine list — 返回语音引擎资源的分页列表。
  • elevenlabs-pp-cli speech-engine update — 更新语音引擎资源（部分更新）

speech-to-speech — 结合你上传的音频文件的风格和内容，以及所选语音来创建语音。

  • elevenlabs-pp-cli speech-to-speech <voice_id> — 将音频从一种语音转换为另一种语音。全面控制情绪、时机和表达方式。

speech-to-text — 使用我们的尖端模型转录音频文件，并提供详细的说话人标注和精确时间戳。

  • elevenlabs-pp-cli speech-to-text delete-transcript-by-id — 根据 ID 删除之前生成的转录文本。
  • elevenlabs-pp-cli speech-to-text get-transcript-by-id — 根据 ID 获取之前生成的转录文本。
  • elevenlabs-pp-cli speech-to-text speech_to_text — 转录音频或视频文件。如果 webhook 设置为 true，请求将以异步方式处理，并……

studio — 以编程方式访问、创建和转换 Studio 项目。只有明确列入白名单的账户才能访问 Studio API。如需访问权限，请联系我们的销售团队。

  • elevenlabs-pp-cli studio add-chapter — 创建新章节，可以创建空白章节，也可以从 URL 创建。
  • elevenlabs-pp-cli studio add-project — 创建新的 Studio 项目，可将其初始化为空白项目、从文档创建或从 URL 创建。
  • elevenlabs-pp-cli studio convert-chapter-endpoint — 开始转换指定章节。
  • elevenlabs-pp-cli studio convert-project-endpoint — 开始转换 Studio 项目及其所有章节。
  • elevenlabs-pp-cli studio create-podcast — 创建并自动转换播客项目。目前，大模型费用由我们承担，但您仍需支付……
  • elevenlabs-pp-cli studio delete-chapter-endpoint — 删除章节。
  • elevenlabs-pp-cli studio delete-project — 删除 Studio 项目。
  • elevenlabs-pp-cli studio edit-chapter — 更新章节。
  • elevenlabs-pp-cli studio edit-project — 通过设置传入参数的值来更新指定的 Studio 项目。
  • elevenlabs-pp-cli studio edit-project-content — 更新 Studio 项目内容。
  • elevenlabs-pp-cli studio get-chapter-by-id-endpoint — 返回指定章节的信息。
  • elevenlabs-pp-cli studio get-chapter-snapshot-endpoint — 返回章节快照。
  • elevenlabs-pp-cli studio get-chapter-snapshots — 获取章节所有快照的信息。每个快照都可下载为音频。每当章节……
  • elevenlabs-pp-cli studio get-chapters — 返回 Studio 项目的章节列表。
  • elevenlabs-pp-cli studio get-project-by-id — 返回指定 Studio 项目的信息。此端点会返回有关项目的更详细信息……
  • elevenlabs-pp-cli studio get-project-muted-tracks-endpoint — 返回项目中包含静音音轨的章节 ID 列表。
  • elevenlabs-pp-cli studio get-project-snapshot-endpoint — 返回项目快照。
  • elevenlabs-pp-cli studio get-project-snapshots — 获取 Studio 项目的快照列表。
  • elevenlabs-pp-cli studio get-projects — 返回您的 Studio 项目及其元数据列表。
  • elevenlabs-pp-cli studio stream-chapter-snapshot-audio — 流式传输章节快照中的音频。使用 GET /v1/studio/projects/{project_id}/chapters/{chapter_id}/snapshots……
  • elevenlabs-pp-cli studio stream-project-snapshot-archive-endpoint — 返回 Studio 项目音频的压缩存档。
  • elevenlabs-pp-cli studio stream-project-snapshot-audio-endpoint — 流式传输 Studio 项目快照中的音频。
  • elevenlabs-pp-cli studio update-pronunciation-dictionaries — 创建一组适用于项目的发音词典。这将自动标记其中的文本……

text-to-dialogue — 管理文本转对话

  • elevenlabs-pp-cli text-to-dialogue full-with-timestamps — 根据文本生成对话，并提供精确到字符级别的时间信息，用于音频与文本同步。
  • elevenlabs-pp-cli text-to-dialogue stream — 将文本和语音 ID 对列表转换为语音（对话），并返回音频流。
  • elevenlabs-pp-cli text-to-dialogue stream-with-timestamps — 将文本和语音 ID 对列表转换为语音（对话），并返回包含……的 JSON 数据流。
  • elevenlabs-pp-cli text-to-dialogue text_to_dialogue — 将文本和语音 ID 对列表转换为语音（对话），并返回音频。

text-to-speech — 使用所选语音将文本转换为逼真语音。

  • elevenlabs-pp-cli text-to-speech <voice_id> — 使用所选语音将文本转换为语音，并返回音频。

text-to-voice — 管理文本转语音

  • elevenlabs-pp-cli text-to-voice create-voice — 从之前生成的语音预览创建语音。应在获取……后调用此端点
  • elevenlabs-pp-cli text-to-voice design — 通过提示词设计语音。此方法会返回语音预览列表。每个预览都有一个 generated_voice_id 和……
  • elevenlabs-pp-cli text-to-voice text_to_voice — 已弃用。 请改用 POST /v1/text-to-voice/design。根据语音描述生成自定义语音……

usage — 管理用量

  • elevenlabs-pp-cli usage —（已弃用）此端点已弃用。请改用 /v1/workspace/analytics/query/usage-by-product-over-time……

user — 管理用户

  • elevenlabs-pp-cli user get-info — 获取用户信息
  • elevenlabs-pp-cli user get-subscription-info — 获取用户的扩展信息

voices — 访问由你或 ElevenLabs 创建的语音。

  • elevenlabs-pp-cli voices add — 将新语音添加到 VoiceLab 中的语音收藏。
  • elevenlabs-pp-cli voices add-pvc-samples — 为 PVC 语音添加音频样本
  • elevenlabs-pp-cli voices add-sharing — 将共享语音添加到语音收藏。
  • elevenlabs-pp-cli voices create-pvc — 创建带有元数据但不含样本的全新 PVC 语音
  • elevenlabs-pp-cli voices delete — 根据语音 ID 删除语音。
  • elevenlabs-pp-cli voices delete-pvc-sample — 删除 PVC 语音中的样本。
  • elevenlabs-pp-cli voices edit-pvc — 编辑 PVC 语音元数据
  • elevenlabs-pp-cli voices edit-pvc-sample — 更新 PVC 语音样本——应用降噪、选择说话人、更改裁剪时间或文件名。
  • elevenlabs-pp-cli voices get — 返回用户所有可用语音的列表。当用户工作区中的语音超过 500 个时，此功能将停止工作。
  • elevenlabs-pp-cli voices get-by-id — 返回特定语音的元数据。
  • elevenlabs-pp-cli voices get-pvc-captcha — 获取 PVC 语音验证所需的验证码。
  • elevenlabs-pp-cli voices get-pvc-sample-audio — 获取语音样本音频的前 30 秒，可选择是否降噪。
  • elevenlabs-pp-cli voices get-pvc-sample-speakers — 获取说话人分离过程的状态；若已完成，则返回检测到的说话人列表。
  • elevenlabs-pp-cli voices get-pvc-sample-visual-waveform — 获取语音样本的可视化波形。
  • elevenlabs-pp-cli voices get-settings-default — 获取语音的默认设置。'similarity_boost' 对应网页中的“清晰度 + 相似度增强”……
  • elevenlabs-pp-cli voices get-speaker-audio — 获取特定说话人分离出的音频。
  • elevenlabs-pp-cli voices get-user-v2 — 获取用户所有可用语音的列表，支持搜索、筛选和分页。
  • elevenlabs-pp-cli voices request-pvc-manual-verification — 请求对 PVC 语音进行人工验证。
  • elevenlabs-pp-cli voices run-pvc-training — 启动语音的 PVC 训练流程。
  • elevenlabs-pp-cli voices start-speaker-separation — 启动样本的说话人分离流程
  • elevenlabs-pp-cli voices verify-pvc-captcha — 提交 PVC 语音的验证码验证。

workspace — 访问工作区相关端点。

  • elevenlabs-pp-cli workspace add-member — 将工作区成员添加到指定群组。需要 group_members_manage 权限。
  • elevenlabs-pp-cli workspace create-auth-connection — 为工作区创建新的 OAuth2 身份验证连接
  • elevenlabs-pp-cli workspace create-webhook-route — 使用指定的身份验证类型为工作区创建新的 webhook。
  • elevenlabs-pp-cli workspace delete-auth-connection — 删除工作区身份验证连接
  • elevenlabs-pp-cli workspace delete-invite — 使现有的电子邮件邀请失效。该邀请仍会显示在已收到邀请的收件箱中，...
  • elevenlabs-pp-cli workspace delete-webhook-route — 删除指定的工作区 webhook
  • elevenlabs-pp-cli workspace edit-webhook-route — 更新指定的工作区 webhook
  • elevenlabs-pp-cli workspace get-audit-logs — 返回工作区的审计日志。需要企业版套餐和 audit_log_read 权限。
  • elevenlabs-pp-cli workspace get-groups-endpoint — 获取工作区中的所有群组
  • elevenlabs-pp-cli workspace get-resource-metadata — 根据资源 ID 获取资源元数据。
  • elevenlabs-pp-cli workspace get-webhooks-route — 列出工作区的所有 webhook
  • elevenlabs-pp-cli workspace invite-user — 向提供的电子邮件地址发送加入工作区的邀请。如果用户没有账户，他们...
  • elevenlabs-pp-cli workspace invite-users-bulk — 向提供的电子邮件地址发送加入工作区的邀请。所有电子邮件地址都必须属于...
  • elevenlabs-pp-cli workspace list-auth-connections — 获取工作区的所有身份验证连接
  • elevenlabs-pp-cli workspace remove-member — 从指定群组中移除成员。需要 group_members_manage 权限。
  • elevenlabs-pp-cli workspace requests-list — 返回 API 请求列表。支持按时间范围、列筛选器和搜索词筛选。至少需要一个...
  • elevenlabs-pp-cli workspace search-groups — 搜索工作区中的用户群组。可能返回多个群组，也可能不返回任何群组。
  • elevenlabs-pp-cli workspace share-resource-endpoint — 向用户或群组授予工作区资源的角色。它会覆盖此用户/服务...
  • elevenlabs-pp-cli workspace unshare-resource-endpoint — 移除用户、服务账户、群组或工作区 API 密钥在工作区资源上已有的角色。要...
  • elevenlabs-pp-cli workspace update-member — 更新工作区成员的属性。除电子邮件标识符外，所有参数都将保持不变...
  • elevenlabs-pp-cli workspace usage-by-product-over-time — 返回按产品类型随时间细分的额度用量。响应为包含各列的表格结构，...
Voice budget

运行 elevenlabs-pp-cli voice-budget --json，查看剩余字符额度、下次重置时间，以及规划大型渲染前可用的语音槽余量。每次运行都会获取最新的订阅响应，并使用服务提供方的 voice_slots_used 计数器。终端视图会显示准确的 UTC 重置时间和剩余语音槽数。

查找合适的命令

如果你知道想做什么，但不知道该使用哪个命令，可以直接询问 CLI：

elevenlabs-pp-cli which "<capability in your own words>"

which 会根据自然语言功能查询，从此 CLI 精选的功能索引中找出最匹配的命令。退出代码 0 表示至少找到一个匹配项；退出代码 2 表示无法确定匹配项——请改用 --help，或使用更具体的查询。

身份验证设置

运行 elevenlabs-pp-cli auth setup，打印获取密钥所需的网址和步骤（添加 --launch 可打开网址）。然后设置：

export ELEVENLABS_API_KEY="<your-key>"

或者将其保存到 ~/.config/elevenlabs-documentation-pp-cli/config.toml。

运行 elevenlabs-pp-cli doctor 验证设置。

Agent 模式

在任意命令中添加 --agent。它会展开为：--json --compact --no-input --no-color --yes。

  • 可管道传递 — JSON 输出到 stdout，错误输出到 stderr

  • 可筛选 — --select 保留部分字段。点分路径可深入嵌套结构；数组会逐元素遍历。在响应内容冗长的 API 中，这对控制上下文大小至关重要：

    elevenlabs-pp-cli models --agent --select id,name,status

  • 可预览 — --dry-run 显示请求，但不发送

  • 适合离线使用 — 有本地 SQLite 存储时，同步／搜索命令可使用该存储

  • 非交互式 — 绝不提示输入；所有输入均通过标志传入

  • 明确重试行为 — 仅当已存在的创建对象应视为成功时才使用 --idempotent；仅当缺失的删除目标应视为成功时才使用 --ignore-missing

响应信封

从本地存储或 API 读取的命令会将输出包装在来源信封中：

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

从 .results 解析数据，并通过 .meta.source 判断数据来自实时来源还是本地来源。只有当 stdout 连接到终端时，才会将人类可读的 N results (live) 摘要打印到 stderr；通过管道传递或供 Agent 使用时，stdout 仅输出纯 JSON。

Agent 反馈

当你（或 Agent）发现此 CLI 有不妥之处时，请记录下来：

elevenlabs-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
elevenlabs-pp-cli feedback --stdin < notes.txt
elevenlabs-pp-cli feedback list --json --limit 10

条目会本地存储在 ~/.elevenlabs-pp-cli/feedback.jsonl 中。除非设置了 ELEVENLABS_FEEDBACK_ENDPOINT，并且传入了 --send 或 ELEVENLABS_FEEDBACK_AUTO_SEND=true，否则不会发送 POST 请求。默认行为仅在本地存储。

写下让你感到意外的地方，而不是提交错误报告。简短、具体，且只写一行：这才是能够不断积累价值的内容。

输出传递

每个命令都接受 --deliver <sink>。除 stdout 外，或代替 stdout，输出也会发送到指定的接收目标，因此 Agent 无需手动通过管道传递命令结果。支持三种接收目标：

接收目标效果
stdout默认；仅写入 stdout
file:<path>将输出原子写入 <path>（临时文件 + 重命名）
webhook:<url>将输出正文 POST 到该 URL（使用 --compact 时，内容类型为 application/json 或 application/x-ndjson）

对于未知方案，系统会拒绝并返回结构化错误，其中会列出受支持的方案。Webhook 请求失败时会返回非零状态码，并在 stderr 中记录 URL 和 HTTP 状态码。

命名配置

配置是保存的一组标志值，可在多次调用中重复使用。当计划任务中的 Agent 每次都以相同配置调用同一命令时，可使用配置，例如 HeyGen 的 “Beacon” 模式。

elevenlabs-pp-cli profile save briefing --json
elevenlabs-pp-cli --profile briefing models
elevenlabs-pp-cli profile list --json
elevenlabs-pp-cli profile show briefing
elevenlabs-pp-cli profile delete briefing --yes

显式标志始终优先于配置值；配置值优先于默认值。agent-context 会在 available_profiles 下列出所有可用配置，以便 Agent 在运行时发现它们。

退出码

代码含义
0成功
2用法错误（参数错误）
3未找到资源
4需要身份验证
5API 错误（上游问题）
7触发速率限制（等待后重试）
10配置错误

参数解析

解析 $ARGUMENTS：

  1. 为空、help 或 --help → 显示 elevenlabs-pp-cli --help 输出
  2. 以 install 开头 → 以 mcp 结尾 → 安装 MCP；否则 → 参见上文的先决条件
  3. 其他内容 → 直接使用（作为带有 --agent 的 CLI 命令执行）

MCP 服务安装

  1. 安装 MCP 服务： 
    go install github.com/mvanhorn/printing-press-library/library/ai/elevenlabs/cmd/elevenlabs-pp-mcp@latest
  2. 在 Claude Code 中注册： 
    claude mcp add elevenlabs-pp-mcp -- elevenlabs-pp-mcp
  3. 验证：claude mcp list

直接使用

  1. 检查是否已安装：which elevenlabs-pp-cli 如果未找到，提供安装选项（参见本技能开头的先决条件）。
  2. 根据用户的查询，从上文的“独特功能”和“命令参考”中选择最合适的命令。
  3. 使用 --agent 标志执行： 
    elevenlabs-pp-cli <command> [subcommand] [args] --agent
  4. 如果含义不明确，请查看子命令帮助：elevenlabs-pp-cli <command> --help。

评论

支持 Markdown