音效 (ElevenLabs)

概述

使用 ElevenLabs 音效 API 根据文本提示生成音效。默认输出为 MP3 格式；可转换为 .ogg/opus 格式以便在 WhatsApp 移动端播放。

快速开始

1. 设置 API 密钥：

• ELEVENLABS_API_KEY（推荐）或XI_API_KEY
• 或者在~/.clawdbot/clawdbot.json文件中设置skills."sound-fx".env.ELEVENLABS_API_KEY

2. 生成音效 (MP3)：

scripts/generate_sfx.sh --text "short audience applause" --out "/tmp/applause.mp3" --duration 1.2

3. 转换为 WhatsApp 友好的 .ogg/opus 格式（如果需要）：

ffmpeg -y -i /tmp/applause.mp3 -c:a libopus -b:a 48k /tmp/applause.ogg

脚本：scripts/generate_sfx.sh

用法

scripts/generate_sfx.sh --text "canned laughter" --out "/tmp/laugh.mp3" --duration 1.5

说明

• 使用POST https://api.elevenlabs.io/v1/sound-generation
• 支持可选参数--duration（0.5–30 秒）。省略时，时长自动设定。
• 打印媒体: <路径>关于自动附加的成功操作。

示例

• 掌声:"简短的观众掌声"
• 笑声:"录制好的观众笑声"
• 呼啸声:"快速的呼啸声"
• 环境音:"轻柔的雨声环境音"