mcpField
E
elevenlabs-tts

elevenlabs-tts

github.com/glebis创意与媒体402307 次安装2 天前更新
代码仓库

关于 elevenlabs-tts

elevenlabs-tts 是通过 ElevenLabs 文本转语音 API 生成音频的技能，适合需要语音内容的开发者和创作者。它提供预设音色、可调语音参数，以及可通过 Python 或命令行调用的脚本。

主要功能

  1. 01通过 ElevenLabs API 将文本转为语音
  2. 02提供七种预设音色
  3. 03支持指定音色 ID 和调节语音参数
  4. 04可从 Python 导入或通过命令行运行
  5. 05可设置输出路径并自动创建目录

适用场景

  1. 01为文本生成旁白音频
  2. 02使用不同预设音色制作语音内容
  3. 03在 Python 程序中生成语音文件
  4. 04通过命令行指定音色和输出位置

安装

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

$npx skills add https://github.com/glebis/claude-skills --skill elevenlabs-tts

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

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.env.example
.gitignore
requirements.txt
.claude-plugin/
plugin.json
references/
api_reference.md
scripts/
elevenlabs_tts.py

详细介绍

ElevenLabs 文本转语音

概述

使用 ElevenLabs 的先进文本转语音 API，将文本生成为专业音频文件。该技能提供预配置的语音预设及合理的默认设置、语音参数自定义功能，并可直接使用 scripts/elevenlabs_tts.py 脚本进行编程控制。

快速开始

将文本生成为音频：

  1. 确保 .env 文件中包含有效的 ELEVENLABS_API_KEY
  2. 执行脚本并传入文本：python scripts/elevenlabs_tts.py "Your text here"
  3. 指定语音和输出路径：python scripts/elevenlabs_tts.py "Text" --voice adam --output audio/output.mp3

语音预设

提供七种预配置语音。完整的语音说明请参阅 references/api_reference.md：

  • rachel（默认）- 清晰、专业的女性声音
  • adam - 深沉、权威的男性声音
  • bella - 温暖、友善的女性声音
  • elli - 年轻、热情的女性声音
  • josh - 友善、健谈的男性声音
  • arnold - 深沉、有力的男性声音
  • ava - 富有表现力、活泼的女性声音

参数

文本

要转换为语音的文本。支持任意长度。

语音选择

使用预设名称（例如 rachel、adam）或直接使用 ElevenLabs 语音 ID 指定语音。

语音参数
  • stability（0.0-1.0，默认值 0.5）：值越低，表达变化越丰富；值越高，语音越稳定一致
  • similarity_boost（0.0-1.0，默认值 0.75）：值越高，生成的语音越贴近其语音特征
输出

指定输出文件路径。默认值为 output.mp3。目录会自动创建。

使用示例

基本 Python 用法
from scripts.elevenlabs_tts import generate_speech

path = generate_speech(
    text="Hello, this is a test message",
    voice_id="rachel"
)
命令行
# With default voice
python scripts/elevenlabs_tts.py "Generate this text"

# With custom voice and stability
python scripts/elevenlabs_tts.py "Different voice" --voice adam --stability 0.7

# To custom output path
python scripts/elevenlabs_tts.py "Save here" --output audio/narration.mp3

# List available voices
python scripts/elevenlabs_tts.py "" --list-voices

实现说明

  • 脚本负责处理 API 通信并报告错误
  • 如果输出目录不存在，会自动创建
  • 返回生成的音频文件的绝对路径
  • 默认使用 eleven_monolingual_v1 模型（可覆盖）

资源

  • scripts/elevenlabs_tts.py - 用于文本转语音生成的 Python 主脚本。可作为模块导入，也可从命令行执行。
  • references/api_reference.md - 详细的 API 文档，包含语音说明、参数解释和使用示例。
  • .env 和 .env.example - 用于安全存储 API 凭据的环境配置文件。

评论

支持 Markdown