名称： elevenlabs
描述： 通过 ElevenLabs API 实现文本转语音、音效生成、音乐生成、语音管理及配额查询。适用于使用 ElevenLabs 生成音频或管理语音的场景。
元数据： {"clawdbot":{"requires":{"bins":["python3"],"env":["ELEVENLABS_API_KEY"]},"primaryEnv":"ELEVENLABS_API_KEY"}}

ElevenLabs 技能

用于与 ElevenLabs API 交互，实现声音生成、音乐制作和语音管理的核心工具集。

环境配置

需要在环境变量中设置 ELEVENLABS_API_KEY。

输出格式

所有脚本均支持通过 --format 参数指定多种输出格式：

工具说明

1. 语音合成 (speech.py)

使用 ElevenLabs 语音进行文本转语音。

# 基本用法
python3 {baseDir}/scripts/speech.py "Hello world" -v <voice_id> -o output.mp3

# 指定输出格式
python3 {baseDir}/scripts/speech.py "Hello world" -v <voice_id> -o output.pcm --format pcm_44100

# 自定义语音参数
python3 {baseDir}/scripts/speech.py "Hello" -v <voice_id> -o out.mp3 --stability 0.7 --similarity 0.8

2. 音效生成 (sfx.py)

生成音效和短音频片段。

# 生成音效
python3 {baseDir}/scripts/sfx.py "Cinematic boom" -o boom.mp3

# 生成循环音效
python3 {baseDir}/scripts/sfx.py "Lo-fi hip hop beat" --duration 10 --loop -o beat.mp3

# 指定格式输出
python3 {baseDir}/scripts/sfx.py "Whoosh" -o whoosh.pcm --format pcm_44100

3. 音乐生成 (music.py)

生成完整的音乐作品或器乐轨道。

# 生成器乐开场
python3 {baseDir}/scripts/music.py --prompt "Upbeat 6s news intro sting, instrumental" --length-ms 6000 -o intro.mp3

# 生成背景音乐
python3 {baseDir}/scripts/music.py --prompt "Soft ambient synth pad" --length-ms 30000 -o bed.mp3

# 高质量 MP3 输出
python3 {baseDir}/scripts/music.py --prompt "Jazz piano" --length-ms 10000 -o jazz.mp3 --output-format mp3_44100_192

4. 语音管理 (voices.py)

列出可用语音及其 ID。

# 列出语音
python3 {baseDir}/scripts/voices.py

# JSON 格式输出
python3 {baseDir}/scripts/voices.py --json

5. 语音克隆 (voiceclone.py)

从音频样本创建即时语音克隆。

# 从音频文件克隆
python3 {baseDir}/scripts/voiceclone.py --name "MyVoice" --files sample1.mp3 sample2.mp3

# 指定语言和性别标签
python3 {baseDir}/scripts/voiceclone.py --name "Andi" --files *.m4a --language de --gender male

# 添加描述并启用降噪
python3 {baseDir}/scripts/voiceclone.py --name "Andi" --files *.m4a --description "German male" --denoise

6. 配额与用量 (quota.py)

查询订阅配额和使用统计。

# 查看当前配额
python3 {baseDir}/scripts/quota.py

# 包含按语音的用量明细
python3 {baseDir}/scripts/quota.py --usage

# 最近 7 天用量
python3 {baseDir}/scripts/quota.py --usage --days 7

# JSON 格式输出
python3 {baseDir}/scripts/quota.py --json

输出示例：

📊 ElevenLabs 配额
=======================================
套餐：      pro（有效）— 年付
字符数：    66.6K / 500.0K (13.3%)
           [███░░░░░░░░░░░░░░░░░░░░░░░░░░░]
重置时间：  2026-02-18 (29 天后)
语音数：    22 / 160 (IVC: ✓)
专业语音：  0 / 1 (PVC: ✓)